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PREFACE 


THIS DOCUMENT IS DIVIDED INTO TWO PARTS. PART Is OPERATING THE 85500 
TIME SHARING SYSTEMs DESCRIBES THE DIFFERENCES BETWEEN THE TIME SHARING 
SYSTEM AND THE STANDARD SYSTEM, THE READER IS ASSUMED TO BE FAMILIAR 
WITH OPERATION OF THE STANDARD B5500 SYSTEM AS DESCRIBED IN THE 
OPERATIONS MANUAL, PART IIs PROGRAMMING INFORMATIONS CONTAINS DETAILED 
DESCRIPTIONS OF THE PROCEDURES AND PROGRAMS IN THE TIME SHARING SYSTEM 
WHICH ARE NOT A PART OF THE STANDARD SYSTEM. SINCE IT.IS INTENDED 
PRIMARILY FOR THE SYSTEMS PROGRAMMER, THE READER IS EXPECTED TO BE 


FAMILIAR WITH THE CODING OF THE STANDARD MCP, 


PART I 


OPERATION OF THE TIME SHARING SYSTEM 


OPERATING THE TSS MCP 


THE OPERATION OF THE TSS MCP IS QUITE SIMILAR TO THAT OF THE STANDARD 
MCP. THE CHANGES THAT HAVE BEEN MADE TO ALLOW TIME SHARING ARE MOSTLY 
ADDITIONS, FOR INSTANCEs MOST OF THE KEYBOARD INPUT MESSAGES HAVE 

BEEN RETAINED AND SEVERAL NEW ONES HAVE BEEN ADDEDe THUSs ANYONE 
FAMILIAR WITH THE OPERATION OF THE STANDARD MCP SHOULD HAVE NO TROUBLE 


OPERATING THE TSS MCP, 


IN ORDER TO USE REMOTE TERMINAL» THE OCTU MUST BE IN REMOTE AND THE 
FILE SYSTEM/DISKs CONTAINING INFORMATION ABOUT THE HARDWARE SET UP 
QF EACH LINE» MUST BE PRESENT, IF EITHER OF THESE CONDITIONS IS NOT 
MET AFTER A HALT/LOAD OR WHEN SETTING THE REMOTE OPTION (SEE "OPTIONS" )> 


THE REMOTE OPTION IS RESET AND AN APPROPRIATE MESSAGE, EITHER 


“eNO SYSTEM OISK 


OR 
“*DTC NOT READY 


IS PRINTED AT THE SPO. THE FILE SYSTEM DISK CAN BE CREATED BY RUNNING 


THE PROGRAM SYSODISK/MAKER, 


AS ON THE STANDARD SYSTEMs THE INTRINSICS FILE» INTRNSC/DISKs SHOULD 
ALSO BE ON BISK WHEN A HALT/LOAD IS DONE, TO COMPILE THE INTRINSICS» | 
THE FOLLOWING $ CARD SHOULD BE USED? 


 $ SET TIMESHARING #® TRUE 


IF THIS OPTION Is NOT SET» OR IS SET FALSE» THE RESULTING INTRINSICS 


WILL BE THOSE FOR THE STANDARD SYSTEM, 


AFTER THE HALT/LOAD HAS BEEN PERFORMED, 


IN ORDER TO DO ANY TIME@SHARING 


THE PROGRAM CANDE/TSHARER MUST BE RUNNINGe THIS PROGRAM IS INITIATED 


BY 


THE CANDE 


IN 


TYPING THE CE MESSAGE, 


SOURCE 


SOURCE /CANDE 


MERGSC/CANDE 


LOADSC/CANDE 
APNOSC/CANDE | 
" RSEQSC/CANDE 
DLETSC/CANDE 


COPYSC/CANDE 


LISTSC/CANDE 
GARDSC/CANDE 


FILESC/CANDE 


PAPRSC/CANDE | 


ADDITIONs THE FILE 


MESAGE/CANDE 


FILES MUST BE ON DISK, 


OBJECT 


CANDE/TSHARER 


MERGE /CANDE 


LOAD/CANDE 


APPEND/CANDE 


RESEQ/CANDE 


DELETE/CANDE 


COPY/CANDE 
LIST/CANDE 
GUARD/DISK 
GETFIL/CANDE 
PAPER/CANDE 


WHEN CE IS TYPED» 


THE OBJECT VERSIONS OF 


THESE FILES ARE? 


WHICH CONTAINS THE ERROR MESSAGES MUST ALSO BE PRESENT ON OISKe ALL 


CANDE PROGRAMS ARE COMPILED IN TSPOL, 


THE REMAINING PROGRAM IN THE CANDE LIBRARY IS USERSC/CANDE WHICH 


COMPILES INTO USER/CANDE. THIS PROGRAM CREATES AND UPDATES THE FILE 


USERS/CANDE WHICH CONTAINS THE LIST OF QUALIFIED USERS AND IS DESCRIBED 
ELSEWHERE, 


THE CORE FACTOR APPLIES ONLY TO THE AREA BELOW THE FENCE. IT SHOULD 


-BE SET TO 1 AND THEN LEFT ALONE, 


RUNNING BATCH JOBS 


JOBS MAY BE ENTERED AND RUN VIA THE CARD READER IN THE USUAL WAY, 

WHEN AN EXECUTE CARD IS USEUs, JOBS ARE RUN ABOVE THE FENCE AND ARE 
THEREFORE SUBJECT SWAPPING WITH OTHER JOBS. AS A RESULT» CARE MUST 

BE TAKEN TO ENSURE THAT SUCH JOBS 00 NOT SERIOUSLY DEGRADE THE RESPONSE 
TO THE USER. JOBS CAN BE RUN BELOW THE FENCE BY USING A RUN CARD. 
HOWEVERs EXCEPT FOR A FEW SPECIAL CASES SUCH AS LDCNTRL/OISK CWHICH 

IS BEST STARTED BY AN LODK MESSAGE ANYWAY)» RUNNING JOBS BELOW THE 
FENCE CAUSES A PLETHORA OF NO MEM*S AND SERIOUSLY HAMPERS THE MCP AND 
CANDE, 
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SYSDISK/MAKER 


THE PROGRAM SYSDISK/MAKER IS USED TO CREATE THE FILE SYSTEM/DISK. THE 
INFORMATION NEEDED FOR EACH LINE IS READ IN FREE FIELD FORMAT FROM 


THE CARD FILE PARAM. THE PARAMETERS WHICH ARE READ ARE? 


TU TERMINAL UNIT NUMBER 
BUF BUFFER NUMBER 
PNGPNG PING*PING FLAGe ENTER A 1 IF THIS BUFFER IS A PING*= 


PING BUFFER AND ZERO OTHERWISE. | 
GMFLAG GROUP MARK FLAG» MUST BE 0 FOR A 980 ADAPTER. 


BUFSIZE BUFFER SIZE FOR DATA*COM READS.» MUST BE 28% 56» OR 1126 


‘ADTYP ADAPTER TYPE. ENTER A 1 FOR A 980. 

TERMTYP §-—so REMOTE ~ TERMINAL TYPE. MUST BE A 1 FOR MODEL 33/35 
TELETYPE. | 

XLATE TRANSLATE FLAG. MUST BE 0 FOR A 980 ADAPTER, 


DIRECT DIRECT CONNECTION FLAG. ENTER A 1 IF THIS LINE IS” 


DIRECTLY CONNECTED AND A O IF IT IS A DIAL@UP, 


THE INPUT MUST BE ARRANGED IN ASCENDING ORDER OF TERMINAL UNIT AND 


BUFFER NUMBERS» WITH BUFFER NUMBER THE FASTER MOVING. 


SYSDISK/MAKER SIMPLY READS THE DATA FOR ONE LINE INTO AN ARRAY. AND | 
THEN WRITES THAT DATA ON DISKs CONTINUING UNTIL IT REACHES THE END 
QF THE FILE, CURRENTLY IT DOES NOT PERFORM ANY ERROR CHECKING, HOWEVER» 


A MORE SOPHISTICATED VERSION WILL BE PROVIDED IN THE NEAR FUTURE. 


KEYBOARD INPUT MESSAGES 


THE KEYBOARD INPUT MESSAGES WHICH ARE THE SAME IN BOTH THE STANDARD 


MCP ANDO THE TIME SHARING MCP ARE? 


AX El LS PI RY TR. 
cc ES MX PR SF TS 
CD EX OF PS $0 UL 
CI FM OK | QT ST wO 
CT FR OL RD SV WM 
DB IL ou RM TF WY 
DD uc PB RN TI XI 
pp LO PD RO TL XS 
DT LF PG RW tC«*TCO xT 
EO LR 


THE MESSAGES IN THE STANDARD SYSTEM WHICH ARE NOT INCLUDED IN THE 


TIME SHARING SYSTEM ARES 


BO LI QV 7 5M WA WR 
HM LO RR TC WP ZZ 
HR PT RS 


THE DS» IN AND OT MESSAGES ARE INCLUDED WITH RESTRICTIONS, 


bs CANNOT BE USED IN THE FORM DS<PROGRAM SPECIFIER>» ONLY 
<MIX INDEX>DS IS ALLOWED, 

IN CAN BE USED ONLY WITH JOBS RUNNING BELOW THE FENCE. 

OT CAN BE USED ONLY WITH JOBS RUNNING BELOW THE FENCE. 


THE MESSAGES WHICH HAVE BEEN MODIFIED FOR TIME SHARING ARE BS» CLs 
LN» SC» SS» US AND WU AND THE MESSAGES WHICH HAVE BEEN ADDED ARE CE, 


CX» MFs MUs AND RS» THESE MESSAGES ARE DESCRIBED BELOW. 


THE BS MESSAGE 


THE BS MESSAGE IS USED TO DESIGNATE A TELETYPE AS A SPO» OR TO RESTORE 


QUTPUT TO THE REAL SPO AFTER IT HAS BEEN TURNED OFF BY A US MESSAGE. 
THE FORMATS OF THE BS MESSAGE ARE 


BS SPO 


BS <LOGICAL LINE NUMBER> 


ONLY ONE TELETYPE CAN BE USED AS A SPO AT A TIME. THE BREAK KEY ON 
THE ALTERNATE SPO IS EQUIVALENT TO THE INPUT REQUEST KEY ON THE REAL 
SPO. THE REAL SP MAY RUN CUNCURRENTLY WITH THE ALTERNATE OR MAY BE 
UN@SPO"ED, | | 

THE CE MESSAGE 


THE CE MESSAGE IS USED TO INITIATE CANDE/TSHARERe ITS FORMAT IS 


CE 


THE CL MESSAGE 


THE CL MESSAGE CAN BE USED TO CLEAR A LINE OR TO CLEAR A PERIPHERAL 
UNIT. WHEN A UNIT IS CLEARED» THE JOB WHICH IS USING THAT LINEs IF 


ANYs IS OS*ED. WHEN A LINE IS CLEAREDs THE LINE IS DISCONNECTED AND 


IF THE USER WAS RUNNING A JOB, IT IS DS*ED, THE FORMATS ARES 
CL <UNIT MNEMONIC>? 
CL <LOGICAL LINE NUMBER> 

THE CX MESSAGE 


THE CX MESSAGE IS USED TO SEND MESSAGES TO CANDE. THE MESSAGES ARE 
TREATED LIKE INPUT FROM ANY OTHER LINE AND MUST THEREFORE CONFORM TO 
THE RULES FOR THE COMMAND AND EDIT LANGUAGE. THE FORMAT IS 


CX <MESSAGE> 


THE LN MESSAGE 


THE LN MESSAGES CAUSES THE NAME OF THE FILE LOG/DISK TO BE CHANGED 


AND ALSO CREATES A NEW FILE LOG/DISK, ITS FORMAT IS3 


LN 


THE LNDK MESSAGE 


AFTER AN LNDK MESSAGEs A DISK CHARGES MESSAGE IS ENTERED IN THE LOG 


FOR EACH FILE ON DISK AND THE CREATION DATE AND THE TIME FOR EACH 
FILE IS UPDATEDs THE FORMAT IS 


LNDK 


THE MF MESSAGE 


THE MF MESSAGEs WHICH IS USED TO CHANGE THE LOCATION OF THE FENCE» 


HAS THE FORMAT 
MF <FENCE LOCATION> 


WHERE <FENCE LOCATION> IS AN INTEGER BETWEEN 8184 AND 28644. THE 
LOCATION OF THE FENCE WILL NOT BE CHANGED UNTIL THE NEXT HALT/LOAD> 


AT WHICH TIME IT WILL BE PLACED AT THE SPECIFIED LOCATION, 


THE MU MESSAGE 


THE MU MESSAGE IS USED TO SPECIFY THE MAXIMUM NUMBER QF USERS ALLOWED 

ON THE SYSTEM AT ONE TIME. IF A USER ATTEMPTS TO DIAL*IN WHEN THE 

NUMBER OF USERS IS GREATER THAN OR EQUAL TO THE MAXIMUMs HE IS 
DISCONNECTED. USERS ALREADY LOGGED ON ARE NOT AFFECTED BY AN MU MESSAGE, 


THE FORMATS ARES 


MU 


MU <NUMBER OF USERS> 


IF A NUMBER OF USERS IS NOT GIVEN» THE NUMBER OF LINES PHYSICALLY 


ATTACHED TO THE SYSTEM IS ASSUMED, 


THE RS MESSAGE 


THE RS MESSAGE IS IDENTICAL TO THE SS MESSAGE EXCEPT THAT IT BYPASSES 
CANDE AND CAUSES THE MESSAGE TO THE USER TO BE OUTPUT WITHOUT REGARD 
FOR WHAT THE USER IS DOING. IT SHOULD BE USED ONLY WHEN THE MESSAGE 


NEEDS TO BE SENT IMMEDIATELY. ITS FORMATS ARE 


RS <LOGICAL LINE NUMBER> <MESSAGE> 
RS <USER CODE> <MESSAGE> 


RS ALL <MESSAGE> 
THE RESTRICTIONS CONCERNING THE SEPARATION OF THE LINE NUMBER OR USER 
CODE FROM THE MESSAGE ARE THE SAME AS FOR THE SS MESSAGE. 
THE SC MESSAGE 


THE SC MESSAGE IS USED TO FIND QUT WHICH UNITS ARE DESIGNATED AS SPO 


Se THE FORMAT IS 


sc 


THE SM MESSAGE 


DEPENDING ON ITS FORMATs THE SM MESSAGE IS USED TO OBTAIN A SUMMARY 
OF THE ACTIVITIES ON THE SYSTEMs ON A GIVEN LINEs OR FOR A GIVEN JOB, 
IF THE FORMAT IS 


SM 
A SYSTEM SUMMARY WILL BE PROVIDED AS FOLLOWS: 


1) FOR EACH USER ON THE SYSTEM» ONE OF THE FOLLOWING TWO 
MESSAGES WILL BE TYPED DEPENDING ON WHETHER OR NOT THE USER IS 
CONNECTED TO A NORMAL STATE PROGRAM, 


<USER CODE> ON LINE <LOGICAL LINE NUMBER> 


<USER CODE> ON LINE <LOGICAL LINE NUMBER> USING<JOB SPECIFIER> 
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PST=<PROCESSGR TIME> IN <ELAPSED TIME> 


2) FOR EVERY JOB IN THE MIX WHICH IS NOT CONNECTED TO A REMOTE 


USER» THE FOLLOWING IS TYPED, 


<USER CODE> USING <JOB SPECIFIER> PST=<PROCESSOR TIME> 


IN <ELAPSED TIME> 
IF THERE ARE NO USERS AND NU JOBSs THE ANSWER IS 
NOTHING 
IF THE FORMAT IS 
SM<LUGICAL LINE NUMBER> 


A SUMMARY OF THE ACTIVITIES ON THAT LINE WILL BE GIVEN AS DESCRIBED 


IN C1de 
IF THE FORMAT IS 
<MIX>SM 


THE SUMMARY WILL BE ONLY FOR THE JOB WITH THE SPECIFIED MIX INDEX. 


THE SS MESSAGE 


THE SS MESSAGE IS USED TO SEND A MESSAGE TO A REMOTE STATION OR 
STATIONSe IF CANDE/TSHARER IS RUNNINGs IT CONTROLS THE SENDING OF THE 
MESSAGE TO THE TERMINAL AND» IF NECESSARY» DELAYS IT UNTIL THE MESSAGE 
CAN BE SENT WITHOUT BEING MiXED WITH OTHER OUTPUT FOR THAT LINE. IF 


CANDE IS NOT RUNNINGs THE MESSAGE IS QUTPUT IMMEDIATELY. 


T-il 


THE SS MESSAGE HAS THREE FORMATS. 


SS <LOGICAL LINE NUMBER><MESSAGE> 
SS <USER CQDE><MESSAGE> 


SS ALL <MESSAGE> 


IN THE FIRST CASE» THE <MESSAGE> WILL BE SENT TO THE SPECIFIED LINEs 


IF THERE IS NO SUCH LINE ON THE SYSTEM, 
LINE <LOGICAL LINE NUMBER> NOT .AVAILABLE 


WILL BE TYPED AT THE SPO AND IF THE LINE IS NOT DIALED*UP» THE MESSAGE 


TYPED ISs8 
LINE <LOGICAL LINE NUMBER> NOT DIALED@=UP 


IN THE SECOND CASEs THE <MESSAGE> WILL BE SENT TO ALL USERS WITH THE 
SPECIFIED <USER*CODE>. IF THERE ARE NONE» THE QUTPUT MESSAGE AT THE 


SPO WILL BE 
<USER CODE> NOT DIALED=uP 


IN THE THIRD CASE» THE <MESSAGE> WILL BE SENT TO ALL LOGGEND*IN STATIONS 


IF CANDE IS RUNNING AND TO ALL DIALED#*UP STATIONS OTHERWISE, 


THE POSITION OF THE FIRST CHARACTER OF THE <MESSAGE> IS DETERMINED 
AS FOLLOWS, IF A <USER CODE> IS GIVEN» THE <MESSAGE> BEGINS WITH THE 
FIRST SPECIAL CHARACTER OR WITH THE EIGHTH CHARACTER. IF A <LOGICAL 
LINE NUMBER> IS USEDs THE <MESSAGE> STARTS WITH THE FIRST NON@*NUMERIC 


CHARACTER OR WITH THE THIRD CHARACTER,» IF ALL IS USEDs, THE <MESSAGE> 


BEGINS IMMEDIATELY AFTER THE SECOND L, IT IS SUGGESTED THAT THE MESSAGE 


ALWAYS BE STARTED WITH A BLANK» FOR EXAMPLE, 


SS JONES NO SUCH TAPE 


THE US MESSAGE 


THE US. MESSAGE "TURNS OFF" THE SPO OR AN ALTERNATE SPOe A TELETYPE 
IS TURNED OFF FOR BOTH INPUT AND OUTPUT, THE SPO CAN STILL BE USED 


FOR INPUT BUT WILL NO LONGER RECEIVE SPO OUTPUT, THE FORMATS ARE 
uS SPO 
US <LOGICAL LINE NUMBER> 

THE WU MESSAGE 


THE WU MESSAGE PROVIDES A WAY TO DISCOVER WHICH USERS ARE DIALED IN»e 
ARE ON GIVEN LINESs OR ARE ATTACHED YO GIVEN PROGRAMS, THE RESULTS 


OF THE WU MESSAGE DEPEND ON ITS FORMAT, IF THE FORMAT IS EITHER 
WU 

OR 
WU<LOGICAL LINE NUMBER> 


THE FOLLOWING WILL BE TYPED AT THE SPQ FOR EACH USER ON THE SYSTEM 


OR FOR THE USER OF THE SPECIFIED LINE? 


<USERCODE> IS ON LINE <LOGICAL LINE NUMBER> 


IF THERE ARE NO USERS» THE MESSAGE IS 
NULL WU, 

IF THE FORMAT IS 
<MIX> WU 


THE USER CODEs LOGICAL LINE NUMBER CIF APPROPRIATE) AND JOB SPECIFIER 


OF THE JOB WITH THE SPECIFIED MIX INDEX ARE QUTPUT AS 


<USER CODE> UN LINE <LOGICAL LINE NUMBER> USING <JOB SPECIFIER> 
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THE OPTIONS 


THE OPTIONS LISTED BELOW CAN BE INIATIALLY SET IN THE COLD START DECK 


AS DESCRIBED FOR THE STANDARD MCP, 


AND TYPED BY THE SO» 


THEREAFTERs THEY CAN BE SETs RESET 


RO AND TO MESSAGESe OPTIONS MARKED BY ASTERISKS 


ARE ADDITIONS FOR THE TIME SHARING SYSTEM AND ARE DESCRIBED IN THE 


PARAGRAPHS FOLLOWING THE LIST, 


47 
46 
45 
44 
43 
42 
41 


40 


* 


USE DRA 
USE DRB 
TYPE BOJ 
TYPE EOJ 
TYPE OPN 


USE TERMNATE 


TYPE DATE 
TYPE TIME 

USE HALT 

USE AUTOPRNT 
USE REMOTE 
USE CHECK 
TYPE CMPLFILE 


* 


* 


IF THE USE HALT OPTION JS SET WHEN 


TYPE CLOSE 
TYPE ERRORMSG 
USE RET 

TYPE LIBMSG 
TYPE SCHEDMSG 
TYPE SECMSG 
USE DSKTOG 
USE RELTOG 
USE PBDREL 
TYPE CEMESS 
TYPE DISKLOG 
TYPE OISKMSG 
TYPE LIBERR 


A SLATE OVERFLOW OR AN INVALID 


ADDRESS IN THE MCP OCCURS» THE MCP WILL HANG AFTER TYPING EITHER 


OR 


**eSHOULD H/Lt HALT CAUSED BY SLATE OVERFLOW 


*ewSHOULD H/L8 HALT CAUSED BY INVALID ADDRESS 


T-15 


THE USE REMOTE OPTION MUST BE SET TO ALLOW DATA*COM I/O, IF THIS 
OPTION IS NOT SET» NO I/O TO OR FROM REMOTE UNITS WILL TAKE PLACE, 
THEREFOREs THIS OPTION SHOULD ALWAYS BE SET FOR NORMAL TIME SHARING 


OPERATION, 


THE USE CHECK OPTION CAUSES A MEMORY LINK CHECK TO BE PERFORMED ON 
ENTRY TO AND EXIT FROM THE ROUTINE GETSPACEse IF AN INVALID LINK IS 
FOUND» THE SYSTEM HANGSe SINCE THIS CHECK 1S RELATIVELY TIME CONSUMING» 
THTS OPTION IS USUALLY SET ONLY FOR DEBUGGING AND IS RESET DURING 


NORMAL SYSTEM OPERATION, 


THE TYPE CEMESS OPTION IS USED IN CONJUNCTION WITH THE TYPE LIBMSG 
OPTION TO CONTROL THE PRINTING OF LIBRARY MAINTENANCE MESSAGES RESULTING 
FROM ACTIONS TAKEN BY CANDEs IF BOTH OPTIONS ARE SET» ALL SUCH MESSAGES 
WILL BE TYPED. IF TYPE CEMESS IS RESET» THE MESSAGES PERTAINING TQ 
CANDE» AND THEREFORE TO REMOTE USERS» WILL NOT BE TYPED. SINCE CANDE 
PERFORMS AN IMMENSE AMOUNT OF LIBRARY MAINTENANCE» THIS OPTION IS 
NORMALLY RESET» | 


IF THE TYPE DISKLOG OPTION IS SET» THE LOG INFORMATION FOR DISK FILES 
WILL BE TYPED AT THE SPOe IF IT IS NOT SET» THE INFORMATION IS NOT 


TYPED. 


WHEN THE TYPE DISKLOG OPTION IS SET» THE MCP WILL TYPE AN ERROR MESSAGE 


WHEN DISK READ OR WRITE ERRORS OCCUR, 


THE TYPE LIBERR OPTION IS USED TO SUPPRESS THE LIBRARY MAINTENANCE 


IGNORED MESSAGES« WHEN THE OPTION IS SET THESE MESSAGES ARE NOT TYPEDe 


WHEN IT IS RESETs THEY ARE. 
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PROGRAMMING LANGUAGES 
Rae a STA TROIS TESA RECON, 


THE LANGUAGES AVAILABLE WITH THE TIME SHARING SYSTEM ARE ALGQL» BASIC» 
COBOL» FORTRANs TSPOL AND XALGOL CALSO CALLED "SAFE" ALGOL)» ALGOL 

AND TSPOL ARE NOT NORMALLY USED FROM A REMOTE TERMINAL. ALGOL IS 
BURROUGHS 85500 ALGOL AS IMPLEMENTED ON THE STANDARD SYSTEM AND TSPOL 
CTIME SHARING PROBLEM ORIENTED LANGUAGE) IS ALGOL WITH THE COMMUNICATE 


STATEMENT ADDEDe 


THIS LEAVES BASICs COBOL» FORTRAN AND XALGOL AS THE LANGUAGES NORMALLY 
USED FROM A REMOTE UNIT. THE VERSIONS OF BASIC AND XALGOL PROVIDED 

ON THE TIME SHARING SYSTEM ARE DESCRIBED IN THE CORRESPONDING MANUALS, 
HOWEVER» THE TIME SHARING VERSIONS OF COBOL AND FORTRAN ARE SLIGHTLY 
MODIFIED VERSIONS OF THE LANGUAGES DESCRIBED IN THE MANUALS FOR THE 


STANDARD SYSTEM AND THEREFORE THE DIFFERENCES ARE SUMMARIZED BELOW. 


ALL LANGUAGES IN THE TIME SHARING SYSTEM MAY BE USED EITHER FROM A 

| REMOTE UNIT OR FROM THE CENTRAL SITE, HOWEVER» IF A PROGRAM RUNNING 
FROM THE CENTRAL SITE ATTEMPTS TO ACCESS A REMOTE UNIT FOR INPUT can 
WILL BE DS*ED. OUTPUT INTENDED FOR A REMOTE UNIT WILL BE TYPED AT THE 


SPO. 


WHEN USING A REMOTE TERMINAL» EACH LINE OF INPUT MUST BEGIN WITH A 
SEQUENCE NUMBER. THESE SEQUENCE NUMBERS ARE EQUIVALENT TO SEQUENCE 
NUMBERS PUNCHED IN COLUMNS 73 THROUGH 80 OF A DATA CARD, FOR REMOTE 
INPUT» THE SEQUENCE NUMBERS ARE CONSIDERED TO EXTEND TO THE FIRST NON 


NUMERIC CHARACTER,» OR FOR A MAXIMUM OF EIGHT CHARACTERS, EVERYTHING 


FOLLOWING THE SEQUENCE NUMBER IS TREATED AS NORMAL INPUT, 


PROGRAMS INPUT FROM OR LISTED AT A REMOTE TERMINAL CANNOT USE THOSE 
SPECIAL CHARACTERS WHICH ARE ILLEGAL FOR REMOTE UNITS, CSEE THE 
TERMINAL USER@S GUIDE+) HOWEVER» SINCE THE SYNTAX OF ALL THE LANGUAGES 
INCLUDES SUBSTITUTES FOR THESE CHARACTERS» E.Ge MNEMONICS FOR THE 
RELATIONAL OPERATORS» THE LANGUAGES THEMSELVES ARE NOT RESTRICTED. 


FOR CARD READER INPUT A NEW $ OPTIONs SEQXEQs HAS BEEN ADDED FOR 


XALGOL» COBOL» AND FORTRAN» AND IS DEFINED AS FOLLOWS: 


SEQXEQ ss2 EXECUTION TIME MESSAGES WILL BE IDENTIFIED BY SEQUENCE 


NUMBER INSTEAD OF RELATIVE ADDRESS. 


THE SEQXEQ OPTION CANNOT BE RESET DURING THE COMPILATION. THAT IS» 
ANY ATTEMPT TO CHANGE IT AFTER PROGRAM CODE HAS BEEN ENCOUNTERED WILL 
BE IGNORED. 


THIS OPTION IS AUTOMATICALLY SET FOR ALL REMOTE JOBS. 


COBOL 


DELETIONS 


THE FOLLOWING CONSTRUCTS HAVE BEEN DELETED IN TIME SHARING COBOL. 


ie "ASSIGN TO DATA.” 

2. "UNTIL® 

3e "WAIT" 

4, “PERFORM (¢ ’ ns 

5. "PERFORM WITH . 
REMOTE I/O 


ACCEPT» DISPLAY» READ AND WRITE MAY ALL BE USED FOR INPUT FROM AND 
QUTPUT TO THE REMOTE UNITe THE SYNTAX FOR USING ACCEPT AND DISPLAY 


FOR THE REMOTE UNIT IS? 


"ACCEPT | FROM REMOTE.” 
"ACCEPT ” 

"DISPLAY UPON REMOTE,.* 
"DISPLAY o” 


THE SPO IS NOW ACCESSED WITH THE SYNTAX 
"ACCEPT FROM KEYBOARD,* 


"DISPLAY UPON MESSAGE*PRINTER.” 


NOTE THAT DATA*NAME MUST BE AN O01 LEVEL NOT GREATER THAN 72 CHARACTERS 


WHEN USED WITH ACCEPT AND DISPLAY. 


THE SYNTAX FOR USING READ AND WRITE IS? 


SELECT : ASSIGN TO REMOTE, 

READ RECORD CINTO 103 AT END 
CELSE 1). 

WRITE (FROM } BEFORE ADVANCING 
LINES. 


THE USE OF ACCEPT AND DISPLAY IS MUCH MORE EFFICIENT THAN THE USE OF 


READ AND WRITE SINCE ACCEPT AND DISPLAY DO NOT GO THROUGH THE INTRINSICS 


INPUT FORMAT 


IN ORDER TO MAKE IT EASIER TO USE THE REMOTE TERMINAL THE FOLLOWING 


CONVENTIONS HAVE BEEN ADOPTED IN PLACE OF THE STANDARD CONVENTIONS. 


1 A CONTINUATION CARD IS SPECIFIED BY A HYPHEN IMMEDIATELY 


AFTER THE SEQUENCE NUMBER, 


Ze A DOLLAR SIGN IMMEDIATELY AFTER THE SEQUENCE NUMBER SPECIFIES 


A DOLLAR CARD, 


3 ANY ALPHABETIC OF NUMERIC CHARACTER OCCURRING IMMEDIATELY 


AFTER THE SEQUENCE NUMBER IS ASSUMED TO BE A LABEL, 


4. PROGRAM. INSTRUCTIONS MUST BE SEPARATED FROM THE SEQUENCE 
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NUMBER BY A BLANK OR MAY FOLLOW A LABEL. 


ALL OTHER CONVENTIONS ARE STANDARD, IT SHOULD ALSO BE NOTED THAT FOR 


PROGRAMS INPUT VIA THE CARD READERs ALL CONVENTIONS ARE STANDARD. 


FORTRAN 


REMOTE TERMINAL DELETIONS 


THE FOLLOWING CONSTRUCTS ARE ILLEGAL WHEN USING A REMOTE TERMINAL AND 
WILL ALSO BE FLAGGED WHEN USING THE CARD READER AND THE TSSDIT OPTIONs 
CSEE $ OPTIONS.) 


Le THE PAUSE STATEMENT 

2 FORMAL PARAMETERS USED AS SUBPROGRAMS 

30 HOLLERITH OR QUOTED STRINGS EXTENDED FROM ONE LINE TO ANOTHER 
4, THE ZIP CONSTRUCT 


NOTE THAT THE WORD "ZIP" IS NO LONGER RESERVED AND THEREFORE CAN BE 
USED LIKE ANY WORD. HOWEVER» SINCE THIS MAY BE CHANGED IN THE FUTURE» 


ITS USE IS DISCOURAGED, 


REMOTE I/0 


THE REMOTE UNIT DESIGNATOR HAS BEEN ADDED TO ALLOW INFORMATION TO BE 
READ FROM OR WRITTEN TO THE REMOTE UNITe USE IN A SOURCE PROGRAM OF 

A FILE CARD CONTAINING "UNIT@REMOTE® WILL CAUSE RELEVANT I/0 STATEMENTS 
TO REFERENCE THE REMOTE TERMINAL, NO BUFFER OR BLOCKING INFORMATION 


IS REQUIRED» AND IF PROVIDED IT WILL BE IGNORED, 


INPUT FORMAT 


IN ORDER TO ELIMINATE THE NECESSITY OF SPACING INPUT» TIME SHARING 
FORTRAN USES “REMOTE FREE FIELD FORMAT* INSTEAD OF THE ORDINARY CARD 
FORMAT,» IN THE RULES GIVEN BELOWs COLUMN 1 REFERS TO THE FIRST COLUMN 
AFTER THE SEQUENCE NUMBER, 


1. CONTINUATION CARDS CONTAIN A *=" TN COL, 1» AND THE CARD 
STARTS WITH THE FIRST NON@*BLANK CHARACTER OR IN COLe 7» WHICHEVER 


COMES FIRST 
COMMENT STARTING IN COLe 3 


Je FILE CARDS MUST START IN COLe 19 CONSEQUENTLY» ANY LINE 
STARTING WITH THE WORD FILE FOLLOWED BY TWO BLANKS MUST BE A 


FILE CARD. 


4. LABELS MAY BE A MAXIMUM OF 5 COLUMNS LONG AND MAY CONTAIN 
EMBEDDED BLANKS, A NON@BLANK NON®NUMERIC CHARACTERs OR THE SIXTH 
COLUMN AFTER THE START OF THE LABEL» ENDS THE LABEL AND STARTS 
THE CARD TEXTe A LABEL MAY BE SEPARATED FROM THE SEQUENCE NUMBER 


BY ANY NUMBER OF BLANKS, 
Se ONLY 66 COLUMNS OF CARD TEXT (SEE 1 AND 4 ABOVE) ARE ALLOWED 


ON ONE LINE. ADDITIONAL TEXT WILL ELICIT SYNTAX ERROR #149, 


$ OPTIONS 


THE $ OPTIONS AVAILABLE ON STANDARD FORTRAN MAY BE USED FROM THE 


REMOTE TERMINAL WITH THE FOLLOWING CHANGES AND ADDITIONS.» 


1e THE $ TSSEDIT OPTION CAUSES THE COMPILER TO CONSIDER THE 
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36 


a, 


Se 


FORMAT OF THE SOURCE FILE TO BE THE ORDINARY RESTRICTED FIELD 
FORMAT RATHER THAN THE REMOTE FREE FIELD FORMAT. THE OPTION IS 
TREATED AS ANY OTHER $ OPTION AND» IF DESIRED» MUST BE RENEWED 


ON EACH $ CONTROL CARD, 


THE $ ERRMES OPTION WILL CAUSE A DESCRIPTION OF THE ERROR 


TO BE TYPED NEXT TO THE ERRONEOUS CONSTRUCT IN THE ERROR MESSAGE. 


THE $ LIST OPTION IS INITIALLY SET "OFF" WHEN COMPILING 
FROM A REMOTE TERMINAL, USE OF THE OPTION WILL RESULT IN A LINE 


PRENTER LISTING IN THE ORDINARY FORMAT. 


THE § ONSITE OPTION CAUSES PRINT STATEMENTS TO REFERENCE 


THE LINE PRINTER AND READ STATEMENTS WITHOUT FILE UNIT DIGITS 
TO REFERENCE THE CARD READER FILE "READER". IF THIS OPTION IS 
NOT USEDs THESE STATEMENTS REFERENCE THE REMOTE TERMINAL BY 
DEFAULT. 


THE $ REMOTE OPTION CSEE 2 BELOW) SIMPLY RESETS THE & ONSITE 


OPTION 


CARD READER, 


1 
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IF THE & TSSEDIT OPTION IS USED» CONSTRUCTS WHICH WOULD BE 
ILLEGAL IF THE PROGRAM WERE BEING COMPILED FROM A REMOTE TERMINAL 
CSEE "DELETIONS") WILL BE FLAGGED WITH WARNING MESSAGES BUT WILL 
STILL BE COMPILED. IF THIS OPTION IS USED WITH THE $ NEW TAPE 


OPTION, THE NEW SYMBOLIC FILE WILL BE IN REMOTE FREE FIELD FORMAT. 


THE $ REMOTE OPTION CAUSES PRINT STATEMENTS AND READ 


STATEMENTS WITHOUT A FILE UNIT DIGIT TO REFERENCE A REMOTE 
TERMINAL INSTEAD OF THE LINE PRINTER OR CARD READERe PROGRAMS 


COMPILED UNDER THIS OPTION CAN BE RUN ONLY FROM A REMOTE TERMINALS 


3 THE $ ONSITE OPTION CSEE 4 ABOVE) SIMPLY RESETS THE $ REMOTE 


OPTION 


FIRST GROUP OF §$ CARDS» IeEes BEFGRE ANY PROGRAM STATEMENTSe IF THEY 
APPEAR AFTER PROGRAM STATEMENTS HAVE BEEN ENCOUNTERED THEY WILL BE 


IGNORED. 


TSPOL 


THE DIFFERENCE BETWEEN TSPOL AND ALGOL IS THE COMMUNICATE STATEMENT» 


THE SYNTAX FOR WHICH IS8 


SYNTAX, 


<COMMUNICATE STATEMENT> 882 COMMUNICATE (<COMMUNICATE NUMBER>) 


<COMMUNICATE NUMBER> 888 <ARITHMETIC EXPRESSION> 
SEMANTICS, 


THIS STATEMENT CAUSES THE CUMMUNICATE OPERATOR TO BE EXECUTED WITH 
THE <COMMUNICATE NUMBER> AT THE TOP OF THE STACK. USE OF <COMMUNICATE 
NUMBER>S FOR WHICH THERE IS NO MCP CODE RESULTS IN AN INVALID INDEX 
IN THE MCPe 


FILE SECURITY 


THE TIME SHARING SYSTEM MAKES USE OF THE FILE SECURITY SYSTEM DEVELOPED 
FOR THE STANDARD MCPe THE USER CODE» PASSWORD AND LOCK FILE IN THE 

TIME SHARING SYSTEM ARE EQUIVALENT TO THE USER CODE» AUTHENTICATION 
CODE AND SECURITY FILE IN THE STANDARD SYSTEMe FILES CREATED FROM THE 
REMOTE UNIT BECOME SOLE USER FILES UNLESS SPECIFIED OTHERWISE VIA 

LOCK AND UNLOCK COMMANDS. LOCK CIE, SECURITY) FILES CAN BE CREATED 

AND UPDATED AT THE CENTRAL SITEs GR FROM THE REMOTE TERMINAL USING 

THE GUARD COMMAND, IT SHOULD BE NOTED THAT SINCE ONE REMOTE USER IS 
NEVER ALLOWED TO MODIFY ANOTHERS FILES» SECONDARY AND TERTIARY USERS 


ARE EQUIVALENT FROM A REMOTE UNIT. 


THE REMOTE/USERS FILE AND THE UPDATE/USERS PROGRAM HAVE BEEN REPLACED 


BY THE USERS/CANDE FILE AND THE USER/CANDE PROGRAM. 


USER/CANDE 


THE NAMES OF ALL AUTHORIZED USERS ARE KEPT IN THE FILE USERS/CANDE» 
WHICH IS CREATED AND UPDATED BY THE PROGRAM USER/CANDE+ THE INPUT 


DECK FOR USER/CANDE CONSISTS OF $ CARDS AND OPTION SPECIFIER CARDS. 
THE $ CARDS ARE 
SNEW SPECIFIES THAT A NEW FILE IS TO BE CREATED. 


SOPTIONS SPECIFIES THAT THE FOLLOWING SET OF OPTION 


SPECIFIER CARDS ARE TO BE USED TO FORM AN 
OPTION BLOCK, 


BUSER "<USER CODE>" SPECIFIES THAT THE FOLLOWING SET OF OPTION 


SPECIFIER CARDS APPLY TO THE NAMED USER. 


IF A $NEW CARD IS USEDs IT MUST BE THE FIRST CARD IN THE DECK, IF 


THERE IS NO $NEW CARD» THE CURRENT USERS/CANDE WILL BE UPDATED. 


THE OPTION BLOCK DEFINES THE DEFAULT OPTIONS, IT IS CREATED AND CHANGED 


BY USE OF THE SOPTION CARD, THE OPTIONS SPECIFIED BETWEEN A $OPTION 
CARD AND THE NEXT $ CARD ARE STORED IN THE OPTION BLOCK, 


THE S$USER CARD CAUSES THE NAMED USER TO BE ADDED TO THE FILE WITH THE 
SPECIFIED OPTIONS IF IT IS A NEW FILE OR IF HE WAS NOT IN IT, OTHERWISE 
THE SUSER CARD CAUSES THE OPTIONS FOR THE SPECIFIED USER TO BE CHANGED. 
IN EITHER CASE» ALL OPTIONS SPECIFIED BETWEEN THE SUSER CARD AND THE 
NEXT $ CARD WILL BE STORED IN THAT USER@S BLOCK, OPTIONS NOT SPECIFIED 
ARE TAKEN FROM THE OPTION BLOCK. 


THE OPTION SPECIFIER CARDS ARE? 
PASSWORD "<1"7 CHARACTERS>® 
SUPPLIES THE USERS PASSWORD 
NAME "“<ANY STRING>" 
SUPPLIES THE USER NAME WHICH IS USED ONLY AT LOG@IN. 


ONE OF THE FULLOWING THREE CARDS SHOULD BE USED TO SPECIFY THE 


OPTIONS FOR THE CHARGE CODE, 
USE CHARGE "<1="7 CHARACTERS>" 

THE CHARGE CODE WILL BE USEE FOR ALL SESSIONS OF THIS USER 
REQUEST CHARGE 


THE USER WILL BE ASKED TO SUPPLY A CHARGE CODE DURING THE LOG= 


IN PROCEDURE, 
NO CHARGE 

A CHARGE CODE IS NOT TO BE USED FOR THIS USER.» 
TIME "<A STRING OF UP TO 24 1*S AND O#S>" 


SPECIFIES THE HOURS OF THE BAY DURING WHICH THE USER WILL BE 
ALLOWED TO RUNe A ONE IN THE STRING SPECIES HOURS WHICH MAY 
BE USED» AND ZERO INDICATES HOURS WHICH MAY NOT BE USED. THE 


FIRST DIGIT IS FOR THE HOUR FROM MIONIGHT TO 1AMs THE SECOND 


FOR 1AM TO 2AM» ETCe IF THE STRING HAS FEWER THAN 24 CHARACTERS 


IT IS FILLED OUT WITH ZEROS ON THE RIGHT, 


LANGUAGES CALGOLICBASICICCOBOLICFORTRANICTSPOLICXALGOL) 


THE USER WILL BE ALLOWED TO USE ONLY THE SPECIFIED LANGUAGES» 


WHICH MAY APPEAR IN ANY ORDER ON THE CARD, 
TELEPHONE <TELEPONE NUMBER> 


THE USERS PHONE NUMBER MAY BE ENTERED, IT SHOULD BE ENTERED 
AS EITHER 7 OR 10 DIGITSs WHICH MAY BE SEPARATED BY HYPHENS, 


THE WORD PHONE MAY BE USED IN PLACE OF TELEPHONE, 
RESTRICT <LIST OF VERBS> 
THE USER WILL NOT BE ALLOWED TO USE THE VERBS IN THE LIST. 


IT SHOULD BE NOTED THAT NO PROVISION HAS BEEN MADE FOR DELETING ENTRIES 
HOWEVER» A USER CAN BE DENIED ACCESS TO THE SYSTEM BY SETTING HIS 
PASSWORD TO A LEFT ARROW (GROUP MARK), TO REMOVE ALL TRACE OF A USER 


FROM THE FILE» A NEW FILE MUST BE CREATED> 


I-30 


USERS/CANDE 


THE FILE USERS/CANDE CONSISTS OF 465 SEGMENTS WHICH ARE UTILIZED AS 


FOLLOWSS 
SEGMENT 0 POINTS TO THE FIRST AVAILABLE USER BLOCK, 
SEGMENTS 1°29 CONTAIN THE USER CODE TABLES 
SEGMENTS 30°464 CONTAIN THE USER BLOCKS, 


THE USER CODE TABLES CONSIST OF TWO WORDS FOR EACH USER» CONTAINING 
THE USER CODE AND THE RELATIVE ADDRESS OF THE USER BLOCK FOR THIS 
USER» THUS» THERE ARE 15 USERS IN A SEGMENT AND 29 SEGMENTS IN THE 
TABLE ALLOWING A MAXIMUM OF 435 QUALIFIED USERS, 


FORTUNATELY» THERE ARE ALSO EXACTLY 435 SEGMENTS FOR USER BLOCKS. THE 


WORDS IN A USER BLOCK CONTAINS 


WORD 0 “MAIL 
i USER CODE 
2 PASSWORD 
3 CHARGE CODE OPTION 


USER NAME 


6 TELEPHONE NUMBER 

7 TIME WORD 

8 COMPILER RESTRICTIONS 

9 VERB RESTRICTIONS | 
10°29 RESERVED FOR EXPANSION 
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SINCE ENTRIES ARE NOT REMOVED FROM THE FILE» THE UNUSED USER BLOCKS 
ARE ALL AT THE END OF THE FILE, THE RELATIVE ADDRESS OF THE FIRST 
UNUSED BLOCK IS STORED IN WORD 1 OF SEGMENT 0. THE RESY OF SEGMENT 0 


IS, CURRENTLY UNUSED, 


THE LOG 


THE TSS LOG KEEPS AN ACCOUNT OF ALL TIME AND DISK SPACE USED BY THE 
REMOTE USERS» WITH SEPARATE ENTRIES FOR THE ELAPSEDs THE I/0 AND THE 
PROCESSOR TIMESe THE PROCESSOR TIME INCLUDES TIME USED FOR LIBRARY 
MAINTENANCE» FILE EDITINGs AND COMMAND LANGUAGE PROCESSINGs AS WELL 
AS THAT RELATED TO THE RUNNING OF PROGRAMS, 


THE LOG IS KEPT IN THE FILE LOG/DISKs» WHICH IS SIMILAR TO SYSTEM/LOG 
ON THE STANDARD MCP IN THAT LIBRARY MAINTENANCE CANNOT BE PERFORMED 
ON IT AND IT MUST BE PROVIDED BY THE INSTALLATION, LOG/DISK CONTAINS 
ALL THE SPO MESSAGES GENERATED BY OR INPUT TO THE SYSTEM. THE USE OF 
OPTIONS TO SUPPRESS SPO MESSAGES DOES NOT AFFECT THE CONTENTS OF THE 
LOGs WHICH ALWAYS CONTAINS ALL THE MESSAGES THAT WOULD APPEAR AT A 
§Po WITH ALL MESSAGE OPTIONS SET, IN ADDITION» THERE ARE TWO BINARY 
"MESSAGES" WHICH APPEAR ONLY IN THE LOG AND CONTAIN INFORMATION NOT 


INCLUDED IN THE SPO MESSAGES, 


LOG/DISK CONSISTS OF 10 WORD LOGICAL RECORDS BLOCKED THREE TO A 
PHYSICAL RECORD. WORD O IS USED TO IDENTIFY THE MESSAGE WHICH APPEARS 
IN WORDS 1°94 THE MESSAGE IS STORED IN UNCOMPACTED FORM$ THAT IS» IT 
HAS NOT BEEN SCANNED TO REMOVE EXTRANEOUS BLANKS. THE FORMAT QF WORD 


Q Ss 


235 MIX INDEX OF THE JOB TO WHICH THIS ENTRY APPLIESe IF 
THERE ITS NO SPECIFIC JOB TO WHICH IT APPLIES» THIS FIELD 


1§ ZERO, 


741 = REMOTE*LOCAL BIT, IT ISt 
1 IF THE WESSAGE APPLIES TO A REMOTE USER, 
0 OTHERWISE, | 
818 LOGICAL LINE NUMBER OF THE REMOTE USER IF THE REMOTE 
LOCAL BIT IS EQUAL TO te OTHERWISE THIS FIELD IS ZERO. 
1687 TYPE OF MESSAGE, 
2411 SPO PRINTOUT BIT. IT IS! 
1 IF THE WESSAGE WAS PRINTED AT THE SPO 
O IF IT WAS NOT 
25:23 TIME OF DAY IN SIXTIETHS OF A SECOND, 


FOR THE LAST RECORD IN THE FILE» BITS 1°47 OF WORD O ARE SET TO 1 AND 


THE REST OF THE RECORD IS LEFT EMPTY, 


THE OPERATOR IS KEPT INFORMED OF THE FULLNESS OF LOG/DISK BY THE 


MESSAGE 
LOG <PERCENTAGE> &% FULL 


WHICH IS PRINTED EVERY 5 PER CENTe THE OPERATOR CAN CREATE AN EMPTY 
LOG/DISK WITH THE LN MESSAGE. WHEN LN IS TYPEDs THE NAME OF THE CURRENT 
LOG/DISK IS CHANGED TO <NUMBER>/LOG AND A NEW FILE NAMED LOG/DISK IS 
CREATED. ALL ENSUING SPO MESSAGES WILL BE STORED IN THE NEW LOG/NISKs 
LEAVING <NUMBER>/DISK TO BE PROCESSED LATER. THE NUMBER HAS 7 DIGITS 
WHERE $ | | 


DIGITS O=1 CONTAIN THE MONTH 
DIGITS 23 CONTAIN THE DATE 


DIGITS 496 ARE THE SERIAL NUMBER, 
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THE SERIAL NUMBERS ARE LIKE THOSE USED FOR PRINTER BACK=UP FILES ON 


DISKe ON A GIVEN DAY» THE FIRST FILE IS NUMBERED O01» THE SECOND O02» 
AND SO ON, IF LOG/DISK BECOMES 95 PER CENT FULL» AN LN IS AUTOMATICALLY 


INITIATED AND THE MESSAGE IS 
LOG 95% FULL CAUTO LN) 


BURROUGHS SUPPLIES A PROGRAM» LOGANN/OISKs TO PROCESS THE FILES < 
NUMBER>/DISK. IT SHOULD BE ADEQUATE FOR MOST INSTALLATIONS AND CAN 

BE USED AS A MODEL IF A DIFFERENT LOGGING PROGRAM IS DESIRED. LOGANN/ 
DISK IS INIATED IN THE USUAL WAY BY MEANS OF AN EXECUTE CARD. WHEN 
THE PROGRAM STARTS IT ASKS VIA THE SPO FOR THE MULTIPLE FILE 
IDENTIFICATION OF THE FILE TO BE ANALYZEDe THE OPERATOR MUST THEN 
TYPE IN | 


<MIX> AX <MULTIPLE FILE IDENTIFICATION> 


IF THE FILE FS NOT ON DISK THE PROGRAM WILL NOTIFY THE QPERATOR WITH 


THE FOLLOWING MESSAGE 
NO FILES <MULTIPLE FILE IDENTIFICATION>/LOG 


AND WILL AGAIN ASK FOR THE MULTIPLE FILE IDENTIFICATION, AFTER 
PROCESSING THE FILE» THE PROGRAM TERMINATES AND MUST THEREFORE BE 
RERUN IN ORDER TO PROCESS ANOTHER FILE. QUTPUT FROM LOGANN/DISK IS 

ON FILE PRNTS WHICH IS NORMALLY THE LINE PRINTER. HOWEVER», SINCE THE 
PROGRAM DOES NOT START PRINTING IMMEDIATELYs IT IS SUGGESTED THAT THE 
BACK UP OPTION BE USED. 


=D 


MESSAGES APPEARING IN THE LQG 


TYPE CONTENTS 


Oo] A MESSAGE NOT APPLICABLE TO LOGGING 
1 A MESSAGE TYPED IN FROM THE SPO 
2 BOU MESSAGE 
3 EOU MESSAGE 
4 PBEOU MESSAGE (PRINTER BACK@UP END OF yOB) 
5 FILE OPEN MESSAGE 
6 FILE CLOSE MESSAGE 
7 HALT/LOAD MESSAGE 
8 EQU STATISTICSs A BINARY RECORD WHICH ALWAYS OCCURS 


IMMEDIATELY IN FRONT OF A EOJ MESSAGE AND PROVIDES TIMING 
INFORMATION FOR THAT JOB | 

IMMEDIATELY BEHIND A FILE CLOSE MESSAGE AND PROVIDES INFORMATION 
CONCERNING THAT FILE, 


10 ON MESSAGEs INDICATES A SUCCESSFUL LOG@INe 

11 OFF MESSAGE, 

12 CHARGE MESSAGE. COUTPUT AFTER A CHARGE COMMANDe) 

13 DISK CHARGES MESSAGE, (OUTPUT WHEN A FILE IS REMOVED.) 
14 DATE MESSAGE 

15 TIME MESSAGE 


THE FORMATS OF THE VARIOUS MESSAGES ARE LISTED BELOW, THE DEFINITIONS 
USED IN THE B5500 OPERATION MANUAL ARE USEO HERE» WITH THE FOLLOWING 
ADDITIONS: | 


<TIME OF DAY> TIME OF DAY IN HOURS AND MINUTES IN THE FORM HHMM, 
<TIME> A TIME GIVEN AS HOURS» MINUTES AND SECONDS» 


SEPARATED BY COLONS IN THE USUAL WAY, 


THE BOJ MESSAGE HAS THREE FORMS? 


<PROGRAM SPECIFIER>/<USER CODE>=<MIXx INDEX>BOU<TIME OF DAY> 
<LOGICAL LINE NUMBER>#<PROGRAM SPECIFIER>=<MIX INDEX> 

BOU<TIME OF DAY> 
<LOGICAL LINE NUMBER>$<PROGRAM SPECIFIER>/<USER CODE>=<MIX INDE X>. 


BOJ<TIME OF DAY> 


THE FIRST FORM IS USED FOR LOCAL JOBS, THE SECOND FORM 3S USED FOR 
REMOTE JOBS WHERE THE <PROGRAM IDENTIFIER SUFFIX> IS EQUAL TQ THE < 
USER CODE>» TeEes USER PROGRAMS. THE THIRD FORM IS USED FOR OTHER 


REMOTE JOBS SUCH AS CANDE PROGRAMS, 


THE EQJ MESSAGE HAS TWO FORMS: 


<PROGRAM SPECIFIER>=<MIX INDEX>sPST=<TIME>EQY 


<PROGRAM SPECIFIER>/<USER CODE>=<MIX INDEX>sPST=<TIME>EOU 


THE FIRST FORM IS USED FOR REMOTE JOBS WHERE THE <PROGRAM IDENTIFIER 
SUFFIX> IS EQUAL TO THE <USER CODE>. THE SECOND FORM IS USED IN ALL 
OTHER CASES, THE <TIME> IS PROCESSOR TIMEs DS*EDs ES=EDs ETC. MAY 


APPEAR INSTEAD OF EQJ, 


PBEOJ MESSAGE 


a ee 


PRNPBT FOR <PROGRAM SPECIFIER>sPSTB<TIME>sIOTS<TIME>JEQN 


WHERE PST IS THE PROCESSOR TIME AND IOT IS THE I/O TIME, 


FILE OPEN MESSAGE 
<UNIT MNEMONIC><IN@*OQUT><DATA FILE DESIGNATOR><RDC>8<JOB SPECIFIER> 


WHERE <IN@OUT> IS IN OR OUTs THIS MESSAGE IS IDENTICAL TO THE MESSAGE 


ON THE STANDARD MCP, 


FILE CLOSE MESSAGE 
<UNIT MNEMONIC>REL<DATA FILE DESIGNATOR><RDC>s3<J0OB SPECIFIER> 


IDENTICAL TO STANDARD MCP MESSAGE. 


FALYT MESSAGE 

*H/L MARK TS*MCP ,<PATCH LEVEL>Fa<FENCE LOCATION> 
C[MODS@2<MEMORY MASK>)@= 

EQJ STATISTICS! 


WORD 1 CONTAINS THE PROCESSOR TIME IN SIXTIETHS OF A SECOND. 


WORD 2 CONTAINS THE I/0 TIME IN SIXTIETHS OF A SECOND, 
WORD 3 CONTAINS THE NUMBER OF WORDS OF CORE USED, 


FILE CLOSE STATISTICS 
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THIS MESSAGE TAKES 5 WORDS AND IS IDENTICAL TO A FILE*INFORMATION 
RECORD ON SYSTEM/LOG FOR THE STANDARD MCP. 
ON MESSAGE 


<USER CODE>ON<LOGICAL LINE NUMBER> 


<USER CODE>ON<LOGICAL LINE NUMBER> (<CHARGE CODE>) 


THE FORM USED DEPENDS ON WHETHER OR NOT A CHARGE CODE IS BEING USED 


FOR THIS USER. 


OFF MESSAGE 


<USER CODE>OFF<LOGICAL LINE NUMBER> 


<USER CODE>OFF<LOGICAL LINE NUMBER> (<CHARGE CODE>) 


CHARGE MESSAGE 


FOR <USER CODE>ON<LOGICAL LINE NUMBER>CHARGE<CHARGE CODE> 


DISK CHARGES MESSAGE 


<FILE SPECIFIER>/<USER CODE>2<NUMBER OF SEGMENTS>SEGS=*CREATED 


<DATED>AT<TIME> 


DATE MESSAGE 
DATE IS <DAY OF WEEK>»<MONTH>/<DAY>/<YEAR> 
TIME MESSAGE 


TIME IS <TIME OF DAY> 


PART II 


PROGRAMMING INFORMATION 


PE LE ETS 
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THE MGP 


THE TIME SHARING MCP IS SIMPLY A MODIFIED VERSION OF THE STANDARD 

MARK VIII MCP. MUCH OF THE TSS*MCP IS THEREFORE ALMOST IDENTICAL TO 

THE CORRESPONDING PARTS OF THE STANDARD MCPe A GOOD EXAMPLE OF THIS 

IS THE WAY IN WHICH NON@*DATA@COMMUNICATIONS I/0 IS PROCESSED. OTHER 
AREASs HOWEVER» HAVE BEEN EXTENSIVELY MODIFIED. FOR INSTANCEs EVERYTHING 
IN THE STANDARD MCP PERTAINING TO DATA COMMUNICATIONS HAS BEEN REMOVED 
ALTHOUGH PARTS OF IT HAVE BEEN REPLACED BY NEW ROUTINES AND PROCEDURES 
WHERE NECESSARY: THE DESCRIPTIONS CONTAINED HEREIN COVER ONLY THOSE 
PARTS OF THE TSS#MCP WHICH ARE NEW OR DIFFER SUBSTANTIALLY FROM THEIR 
COUNTERPARTS IN THE STANDARD MCP, 
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SEGMENTED SAVE. AREAS 


SEGMENTED SAVE AREAS ARE USED THROUGHOUT THE MCP TO PROVIDE A WAY IN 
WHICH PROCEDURES CAN GET 5» 10 OR 20 WORDS OF SPACE WITHOUT LOSING 
CONTROLe THEY ARE USED FOR SUCH THINGS AS THE EVENT QUEUE AND THE 
BUFFERS FOR REMOTE I/O04 EACH AREA IS INENTIFIED IN BITS 13 OF THE 


FIRST WORD OF THE AREA WHERE? 


BIT 1 IS THE OCCUPIED BIT. IT IS 1 IF THIS AREA IS AVAILABLE» 
O IF IT IS IN USE, 
BITS 283 ARE A CODE FOR THE SIZE OF THE AREA WHERE 
O MARKS A 5 WORD AREA 
1 INDICATES A 10 WORD AREA 
2 SIGNIFIES A 20 WORD AREA. 


ALL THE AVAILABLE AREAS OF A GIVEN SIZE ARE KEPT IN A QUEUE» THE HEAD 
AND TAIL OF WHICH ARE KEPT IN SPACER(CI]» WHERE I IS THE SIZE CODE OF 
THE AREAS« THE QUEUE IS LINKED BY THE FIRST WORD IN EACH AREA. THE 
16:15 FIELD POINTS TO THE PREVIOUS AREA IN THE QUEUE AND THE 33315 
FIELD POINTS TO THE NEXT AREA, THE QUEUE IS ORDERED ACCORDING TO TRE 
CORE ADDRESSES OF THE AREAS» WITH AREAS IN LOWEST CORE AT THE HEAD 


OF THE QUEUE, 


DURING INITIALIZATIONs 160 WORDS ARE GOTTEN AND DIVIDED INTO 20 WORD 
AREAS. WHEN A PROCEDURE NEEDS AN AREA IT CALLS GETAREA AND PASSES IT 
THE SIZE CODE OF THE AREA, IF THE QUEUE FOR AREAS OF THAT SIZE IS NOT 
EMPTYs THE FIRST AREA IN THE QUEVE IS RETURNED TO THE CALLING PROCEDURE. 


IF THE QUEVE IS EMPTY» THE QUEUES OF THE LARGER AREAS ARE TESTED UNTIL 
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A NON@EMPTY QUEUE IS FOUND, THE FIRST AREA IN THAT QUEUE IS THEN SPLIT. 


BY HALVING UNTIL AN AREA OF THE DESIRED SIZE IS OBTAINED, THE PIECES 
THUS CREATED ARE LINKED INTO THE APPROPRIATE QUEUES, 


GETAREA ALSO CHECKS THE NUMBER OF 20 WORD AREAS IN THE QUEUE. IF IT 
1S LESS THAN FOUR» IT CALLS FOR M@REAREAS AS AN INDEPENDENT RUNNERS 
MOREAREAS OBTAINS AN ADDITIONAL 160 WORDS WHICH IT DIVIDES INTO 20 
WORD AREAS AND ADDS TO THE QUEUE, RUNNING OUT OF AREAS IS A CAPITAL 
OFFENSES THAT IS» IF GETAREA IS CALLED AND AN AREA OF THE PROPER SIZE 
CANNOT BE OBTAINED» THE SYSTEM IS HUNG, | 


WHEN A PROCEDURE IS THROUGH WITH AN AREAs IT RETURNS IT BY PASSING 
THE SIZE CODE AND ADDRESS OF THE AREA TO FORGETAREAs WHICH RELINKS 
THE AREA INTO THE PROPER QUEUE, HOWEVER» IF THE AREA IS LESS THAN 20 > 
WORDS LONGs IT FIRST CHECKS TO SEE IF THE AREA WHICH FORMS THE OTHER 
HALF OF THE NEXT LARGER AREA IS ALSO AVAILABLE» IN WHICH CASE IT 
DELINKS THAT AREAs AND COMBINES THE TWO HALVES TO FORM A LARGER AREA, 
WHEN NO FURTHER RECOMBINING CAN BE DONE» THE AREA IS ADDED TO THE 
APPROPRIATE QUEUE, 
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MCP TABLES 


MANY OF THE TABLES IN THE TIME SHARING SYSTEM ARE THE SAME AS THE 
CORRESPONDING TABLES IN THE STANDARD MCP AND THEREFORE ONLY THOSE 

TABLES WHICH HAVE BEEN ADDED OR CHANGED ARE DESCRIBED HEREs IN ANDITIONs 
THE DEFINES USED TO ACCESS FIELOS WITHIN THE TABLES ARE ALSO LISTED. 

IN GENERAL» THESE DEFINES ARE OF TWO TYPES. FIRST» A DEFINE MAY BE 


USED FOR A PARTIAL WORD DESIGNATOR» FOR INSTANCE> 


ADINFO.CANDETHRU 


SECOND» PARAMETRIC DEFINES ARE USED TO ACCESS FIELDS AS IF THEY WERE 
THEMSELVES TABLES, FOR EXAMPLE» SCCI} 1S DEFINED TO BE SQLIT).(36!6). 
THE TYPE OF DEFINE BEING USED WITH A GIVEN TABLE IS EXPLAINED IN THE 
DESCRIPTION OF THAT TABLE, 


IN ORDER TO SIMPLIFY THE TASK OF SWAPPING» MCP PARAMETERS PERTAINING 
TO A SPECIFIC JOB ARE KEPT IN THAT JOBS AREA, FOR INSTANCE» THE JAR 

ROW FOR EACH JOB IS KEPT IN ITS AREA, MOST SUCH PARAMETERS» HOWEVER» 
ARE DEFINED TO BE A PART OF THE UV TABLE, 
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UV ARRAY 


THE UV ARRAY CONSISTS OF 15 ENTRIES FOR EACH JOBs ALL OF WHICH ARE 


NORMALLY ACCESSED BY PARAMETRIC DEFINESe FOR INSTANCE» THE TOP OF 


STACK VALUE FOR JOB WITH MIX INDEX ¥ IS ACCESSED AS TOPSK(1], 


IN SOME 


CASES THE UV ENTRY IS A DESCRIPTOR POINTING TO AN ARRAY ROW IN THE 


JOBS AREA, THESE ARRAYS CAN BE ACCESSED JUST AS THEY ARE ON THE 


STANDARD SYSTEM. 


THE CONTENTS OF THE UV ARRAY ROW FOR A GIVEN JOB ARES 


WORD 


0 
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DEFINE 


ELAPSEDOLIMIT 
PROCLIMIT 
TOCOUNT 
TOPSK 
USERCODE 
PRYOR 

FS 

FPBD 


SE GD 


SINFO 


CONTENTS 


MAXIMUM ELAPSED TIME ALLOWED FOR THIS JOB 
BEFORE IT IS SWAPPED OUT, 


MAXIMUM PROCESSOR TIME ALLOWED FOR THIS yOB 


BEFORE IT IS SWAPPED OUT, 


NUMBER OF I/0 OPERATIONS IN PROGRESS FOR 
THIS JOB, | 
ADDRESS OF TOP OF JOB=S STACK WHEN IT IS 
SWAPPED OUT. 

USER@CODE FOR THIS VOB 

PRIORITY OF THIS JOB 

DESCRIPTOR TO FS ROW FOR THIS JOB 


FILE BLOCK DATA DESCRIPTOR FOR THIS JOB 


SEGMENT DICTIONARY NAME DESCRIPTOR FOR TRIS 
JOB s 
1317 CLOCK AT BOJ 


10 


11 
12 
13 
14 


DALOC 


IOTIME 
INTABLE 
PROCTIME 
EVENT 


16815 ESTIMATED CORE REQUIREMENTS 

33815 BOTTOM OF STACK 

DESCRIPTOR TO Row OF DALOC CONTAINING 
ENTRIES PERTAINING TO THIS JOB. 

1/0 TIME USED FOR THIS TIME 

DESCRIPTOR TO INTABLE ROW FOR THIS JOB 
PROCESSOR TIME USED FOR THIS JOB. 

HEAL OF EVENT QUEUE FOR THIS MIX INDEX 


CINCLUDED FOR USE WITH MULTIPLE C&E*S.) 
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TABLES USED IN SWAPPING 


THERE ARE THREE ARRAYS USED IN SWAPPING, THROUGH THE USE OF PARAMETRIC 
DEFINES» FIELOS WITHIN THE WORDS IN THESE ARRAYS ARE THEMSELVES TREATED 
AS ARRAYS. THE DESCRIPTIONS SHOW FOR EACH ARRAYs THE FIELDS OF THE 


ARRAYS DEFINED TO 8E IN THEM, 


SQCOsSMIXMAX+41] 


FIELO DEFINE CONTENTS 

itt | INTERLOCK FOR SWAPPINGIO 

1382.  EXPANDET] FLAGS FOR EXPANDING A JOBS AREA, 

1533 SLNET) NUMBER OF SWAPS FOR JOB WITH MIX INDEX I, 
1886  STASUS(I) STATUS OF JOB Ie 

2436 COUNTET) (NUMBER OF CHUNKS POSSESSED BY JOB I)*1. 
30%6 = LCLTI CHUNK NUMBER OF THE LAST CHUNK FOR JOB I. 
3626 = 8CLT) CHUNK NUMBER OF THE FIRST CHUNK FOR JOB TI. 
4286 LINKUL) MIX INDEX OF JOB FOLLOWING JOB I IN THE SWAP 


OR READY QUEUE. 


CT C(O NUMBER OF CHUNKS] 


FIELD TABLE CONTENTS 


3036 POSSESSCJ) MIX INDEX OF JOB POSSESSING CHUNK Js OR ZERO 
IF CHUNK IS UNPOSSESSED, 


3636 ACTIVECJ) © NUMBER OF JOBS READY TO RUN USING CHUNK J 
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4236 


TOTALE J] 


DATLOS MIXMAX41) 


FIELO 


83:25 


33215 


TABLE 


DISKSTORECT) 
ACTLENCT) 


TOTAL NUMBER OF JOBS ASSIGNED TO CHUNK Je 


CONTENTS 


DISK ADDRESS OF SWAP AREA FOR JOB I 


ACTUAL LENGTH OF STUFF SWAPPED FOR JOB I. 
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TABLES USED BY LINE MAINTENANCE 


ADINFO 


ADINFO IS A ONE DIMENSIONAL TABLE LMAX41 LONGe WORDS 1 THROUGH LMAX 

ARE USED TO STORE INFORMATION ABOUT THE CORRESPONDING LINE. THE DEFINES 
USED TO ACCESS SOME OF THE FIELOS IN ADINFO ARE ALSO LISTEDe THOSE 
MARKED BY ASTERISKS ARE PARAMETRIC DEFINES AND ARE USED AS IF THEY 

WERE INDIVIDUAL TABLES. THE OTHERS ARE USED AS PARTIAL WORD DESIGNATORS 
IN CONJUNCTION WITH ADINFO, 


FIELO DEFINE CONTENTS 


131 DIALEDUP DIAL@UP FLAG. 1 IF LINE IS CONNECTED, OO IF 
NOT 
231 CANDEFLAG | CREP TYPE*JOBeATTACHED FLAG. IF THIS FIELD IS 


1» INPUT GOES TO C&E. 
325 MIXNR MIX INDEX OF JOB TO WHICH THIS LINE IS 
| ATTACHED, (INPUT GOES TO THIS JOB ONLY IF 
ati IS OFF.) 


eB | PINGPING PING@*PING BUFFERS FLAG, 


914 TERMINAL UNIT NUMBER 
1301 GROUP MARK FLAG. 1 IF GROUP MARKS SHOULD BE 


IGNORED. O IF GROUP MARKS TERMINATE I/O, 
14324 BUFFER ADBRESS 
18t2 BUFSIZE BUFFER@SIZE FLAG 


O FOR 28 CHARACTER BUFFERS 
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2033 


2333 


2631 


2731 


2631 


2931 


INPUTANKING 


OUTPUTANKING 


*PAPERTAPE 


1 FOR 56 CHARACTER BUFFERS. 

2 FOR 112 CHARACTER BUFFERS. 

MULTIPLY THIS BY 2 FOR WRITES IF PING@PING 
BUFFERS ARE USED, 


ADAPTER TYPE 


9 = TSS (MODE) 
1 = 980 ADAPTER 
2 = BIOS ADAPTER 


TERMINAL TYPE 


0 


MODEL 37 TELETYPE 

1 = MODEL 33 TELETYPE 

2 = MODEL 35 TELETYPE 

3 = BIDS 

DISK INPUT TANKING FLAG, 

B249 TRANSLATION 

1 IF THE BCL TO INTERNAL CODE TRANSLATION IN 
THE DCTU SHOULD BE USED, 

O IF TRANSLATION IS BYPASSED 

DISK OUTPUT TANKING FLAG. ON WHENEVER THERE 

IS QUTPUT IN THE TANK FOR THIS LINE. 

PAPER TAPE FLAGe WHEN ONs THE CARRIAGE 

RETURN» LINE FEED RESPONSE IS SUPPRESSED 

AND ALL OUTPUT GOING THROUGH DCWRITE IS 

STOPPED (USED WHEN CONTINUOUS PAPER TAPE 

IS BEING READ OR TO STOP OUTPUT WHILE 


DISCARDING OUTPUT TANK AND QUEUE DURING 


IT-11 


DISCONNECT» BREAK AND WRU PROCESSING,) 
3081 *IOINPROGRESS 1/0 IN PROGRESS FLAG. TURNED ON AT IIO TIME 
| AND OFF AT I/O FINISHED TIME, 
3181  CANDETHRU OFF IF C&E IS WORKING ON DISCONNECTING THIS 
LINE. 
3281 DIRECTLINE DIRECT CONNECTION CNON DIAL@UP) FLAG. 
33315 ADDRESS OF LAST BUFFER SEGMENT CIE SEGMENTED 
SAVE AREA) READ INTO BUT NOT YET LINKED 
INTO THE WORKER QUEUE, 


THE FORMAT OF ADINFOCO) IS8 


14:2 | WORD INDEX MINUS 1 OF TAIL OF ANSWERING QUEUE» Io€. IF 
THIS FIELD IS A 1» WORD 2 OF THE AREA POINTED TO BY 188 
15 CONTAINS THE LAST ENTRY IN THE QUEUE 

1632 WORD INDEX MINUS 1 OF HEAD OF ANSWERING QUEUE, 

16815 ADDRESS OF THE AREA CONTAINING THE TAIL OF THE ANSWERING 
QUEUE. 

33:15 ADDRESS OF THE AREA CONTAINING THE HEAD OF THE ANSWERING 
QUEUE. | 


LINE TABLE 


THE LINETABLEs WHICH IS LMAX/4 LONGs IS USED AFTER PASSIVE INTERROGATES 
TO RELATE THE TERMINAL UNIT AND BUFFER NUMBER TO THE LOGICAL LINE 
NUMBER. THE TERMINAL UNIT NUMBER AND THE FIRST TWO BITS OF THE BUFFER 
NUMBER ARE USED AS AN INDEX INTO THE TABLE, FOR INSTANCEs LINETABLET 

0] CONTAINS LOGICAL LINE NUMBERS FOR TERMINAL UNIT O>» BUFFERS O=3, 
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THE FINAL TWO BITS OF THE BUFFER ADDRESS ARE USED TO SPECIFY WHICH 


TWO CHARACTER FIELD CONTAINS THE LOGICAL LINE NUMBER FOR THIS BUFFER, 


SEQARRAY 


THE SEQARRY>» 


WHICH ITS LMAX#1 LONGs IS USED WHEN DOING AUTOMATIC 


SEQUENCING OR WHEN READING PAPER TAPE, FOR SEQUENCING THE WORD FOR 


EACH LINE CONTAINS 


isi 
2:19 
21:27 


20» INDICATES 


INCREMENT 
NEXT SEQUENCE 


WORD IS BEING USED FOR SEQUENCING, 


NUMBER TO BE USED. 


WHEN A PAPER TAPE IS BEING READs THE SEQARRY ENTRY FOR THAT LINE 


CONTAINS 


FIELD 


isi 


2t1 


336 
931 


1038 
16:15 


33315 


DEFINE 


PAPERTAPEFLAG 


OFFSET 


ROWNR 


CONTENTS 


={ TO INDICATE THAT THE WORD IS BEING USED 
FOR PAPER TAPE, 

INDICATES WHICH OF THE 32 WORD BUFFERS IS 
BEING USED. 

INDEX OF NEXT AVAILABLE WORD IN THE BUFFER. 
ON WHEN DOING DISK I/O FOR PAPER TAPE. OFF 
OTHERWISE. | 

NUMBER OF ROWS IN DISK TANK FOR THIS LINE. 
RELATIVE ADDRESS OF FIRST UNUSED SEGMENT IN 
THE CURRENT ROWs 


ADDRESS OF BUFFERS, 
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INPUTANK 


THE ARRAY INPUTANK IS MIXMAX4#4 LONG AND CONTAINS INFORMATION ABOUT 
THE INPUT TANKS FOR EACH JOB IN THE MIXe THE DEFINES USED WITH ‘IT ARE 
USED AS PARTIAL WORD DESIGNATORS, 


FIELO DEFINE CONTENTS 


17:1 NOSABLE ON IF JOB MAY NOT BE DS*ED» E.G. A CANDE JOB 
7 WHICH HAS TO FINISH ITS FILE MANIPULATION, 
1831 INTERLOCK BIT, IF THIS BIT Is OFF THE TANK 
MAY NOT BE TOUCHED. 
19:1  INPUTREADY ON WHEN THE JOB IS SWAPPED OUT WAITING FOR 
| INPUT. 7 
2031 SLOWDOWN USER HAS BEEN TOLD TO STOP HIS INPUT SINCE 
THE TANK IS ALMOST FULL, 
2116 INPUTN | THE NUMBER OF MESSAGES IN THIS yOBS TANK, 
2736  INPUTL ADDRESS WITHIN CLUMP OF NEXT MESSAGE TO BE 
PASSED TO JOB IeEe RELATIVE ADDRESS OF 
WOLDEST™ INPUT, 


TANKS 


THE TANKS ARRAY» WHICH IS LMAX+1 LONG IS USED TO STORE INFORMATION 
ABOUT THE, OUTPUT TANKS FOR THE VARIOUS LINES, EXCEPT FOR DISCONNECTING» 
WHICH IS USED AS A PARTIAL WORD DESIGNATOR» THE DEFINES USED WITH 
TANKS ARE PARAMETRIC: DEFINES, : | 


~IT-14 


FIELD 


134 


333 


631 


10:8 


18%1 


1981 


2031 


2116 


2726 


DEFINE 


DISCONNECTING 


TANKLINE 


TANKSWAP 
TANKFUL 
TANKN 


TANKL 


CONTENTS 


DISCONNECTING FLAG. ON IF NOW IN THE PROCESS 
OF THROWING AWAY OUTPUT FOR THIS LINE DUE 

TO DISCONNECTs BREAK OR WRU. 

ACTIVITY BITs SET AT EACH SWAP AND DC 
INTERRUPT. 

POINTER YO WHICH 7 WORD (56 CHARACTER) PART 
OF THE SEGMENT BEING DETANKED IS NEXT. 

CANDE SHUT*UP FLAG, TURNED ON WHEN A SHUT*UP 
EVENT IS ADDED TO THE QUEUE. 

ON IF CANDE JOB HAS HAD BREAK WHILE RUNNING 
DETANKING QUEUE. THIS CONTAINS THE LINE 
NUMBER OF THE NEXT LINE AFTER THIS LINE FOR 
WHICH DETANKING IS TO BE DONE, CO IF TAIL 

OF QUEUE OR NOT IN QUEUE,) 

INTERLOCK BIT. OUTPUT TANKS MAY NOT BE 
TOUCHED IF THIS BIT IS 0+. 

ON WHEN THE OBJECT JOB IS SWAPPED OUT FOR 
ANY REASON, 

TANK FULL BITs ON WHEN THE OBJECT JOR IS 
SWAPPED OUT TO WAIT FOR TANK TO EMPTY, 
NUMBER OF SEGMENTS USED IN THE TANK FOR THIS 
LINE. 

ADDRESS WITHIN TANK CIeE~ WITHIN THIS USERS 
GLOM) OF SEGMENT OUT OF WHICH NEXT DATA TS 


TO BE TAKENs I.E5~« RELATIVE ADDRESS OF SEGMENT 


TLE=i5 


BEING DETANKED, 


33:15 TANKA CORE ADDRESS OF TANK IN JOB#S AREA USED FOR 
PACKING. 0 IF THERE IS NO SUCH AREA» IE. 


IF OUTPUT IS FROM A CANDE TYPE JOB, 
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THE FORK QUEUVEt ITS STRUCTURE AND OPERATION 


THE FORK QUEUE IS A QUEUE OF REQUESTS TO RUN INDEPENDENT PROCESSES.» 
ENTRIES ARE PUT IN THE QUEUE BY FORKs AND ARE INITIATED BY THE CONTROL 
SECTION OF THE MCP NEAR THE LABELS NOTHINGTODO AND SLATESTARTER+s THE 
ADDRESS OF THE HEAD AND TAIL OF THE QUEUE ARE KEPT IN FORKQUE» WHICH 


HAS THE FORMATS 


033 =5» MARKS THIS AS A PRESENT DATA DESCRIPTOR, 
939 2777 COCTAL) 
8:15 CONTAINS THE ADDRESS OF THE LAST ENTRY IN THE QUEUE. 


33:15 CONTAINS THE ADDRESS OF THE FIRST ENTRY IN THE QUEUE. 


IF THE QUEUE IS EMPTYs THE TWO ADDRESS FIELDS POINT TO FORKQUE. NOTE 
THAT SINCE FORKQUE IS AN ARRAY DESCRIPTOR» THE CONTENTS OF THE FIRST 


ENTRY MAY BE ADDRESSED AS THE ARRAY FORKQUE[*), 


ENTRIES TO THE FORK QUEUE ARE STORED IN 5 WORD SEGMENTED SAVE ARFASs» 


WHERE 8 


WORD 0 989 CONTAINS THE PRIORITY+64, 
18115 IS THE ADDRESS OF THE PRECEDING ENTRY OR OF 
FORKQUE IF THIS IS THF FIRST ENTRY. 
33215 IS THE ADDRESS OF THE NEXT ENTRY» OR OF FORKQUE 
IF THIS IS THE LAST ENTRY. 
WORD 1 18815 CONTAINS LOGLINE. 
33415 IS THE ADDRESS OF THE DESCRIPTOR FOR THE 
ROUTINE 10 BE 


i177 


WORD 3 ZERO IF STACK SPACE HAS BEEN OBTAINEDs OTHERWISE» 
THE AMOUNT OF STACK SPACE NEEDED, 
WORD 4 ADDRESS OF STACK SPACE IF ALREADY OBTAINED AND ZERO 


IF STACK SPACE IS NEEDED. 


THE ENTRIES IN THE FORK QUEUE ARE ORDERED ACCORDING TO PRIORITY AND 


ARE FIRST=IN» FIRST*OUT AMONG EQUAL PRIORITY REQUESTS, 


WHEN CALLEDs FORK IS PASSED THE ADDRESS OF THE PROCEDURE DESCRIPTOR» 

A PARAMETER FOR THE PROCEDURE» THE PRIORITY» THE AMOUNT OF STACK SPACE 
TO BE USED» AND A WORD CONTAINING EITHER THE ADDRESS OF STACK SPACE 
ALREADY OBTAINED OR THE VALUE 1. AFTER GETTING AN AREA» LINKING IT 

INTO THE QUEUE AND STORING THE INFORMATION», FORK RETURNS TO THE CALLING 
PROCEDURE, HOWEVER» FOR PROCEDURES LACKING STACK SPACE» FORK FIRST 
CHECKS THE STACK QUEUEs WHICH IS A QUEUE OF AREAS RESERVED BY INITIALIZE 
FOR USE AS STACKS FOR INDEPENDENT RUNNERS+ THERE ARE NUMSTACK STACKS 
(CURRENTLY DEFINED IN INITIALIZE TO BE 2) AND EACH STACK IS STANDARDSTAC 
LONG (CURRENTLY 90 WORDS), THE STACK AREAS WHICH ARE NOT BEING USED 

ARE LINKED BY THE FIRST WORD OF THE AREAs AND THE ADDRESS OF THE FIRST 
AREA IS KEPT IN STACKQ, IF THERE IS SPACE IN THE STACK QUEUE, FORK 
DELINKS THE FIRST AREA» STORES ITS ADDRESS IN WORD 4 OF THE ENTRY AND 
SETS WORD 3 TO ZERO. IF THE QUEUE IS EMPTYs WORD 3 IS SET TO STANDARDSTA K 


AND WORD 4 IS SET TO ZERO, 


IN ORDER TO START PROCEDURES IN THE FORK QUEUEs NOTHINGTODO CHECKS 
THE QUEVE IMMEDIATELY AFTER INTERROGATING INTERRUPTS, IF THE QUEUE 
IS NOT EMPTY» IT TAKES THE FIRST ENTRYs STORES THE INFORMATION CONTAINED 


THEREIN» DELINKS IT AND FORGETS IT, IF THE PROCEDURE DOES NOT HAVE 
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STACK SPACEs IT CALLS GETSPACE BEFORE INITIATING THE PROCEDURE. IF 
SPACE CANNOT BE OBTAINEDs IT CALLS FORKs WHICH LINKS THE ENTRY BACK 
INTO THE QUEUE BEHIND ANY OTHER ENTRIES WITH THE SAME PRIORITY» AND 
THEN RETURNS TO NOTHINGTOOO. IF THE QUEUE IS EMPTY» NOTHINGTODO GIVES 


UP FORKING AND STARTS TO LOOK FOR SOMETHING IN THE BED. 


WHEN AN INDEPENDENT RUNNER WHICH DOES NOT HAVE ITS OWN STACK IS 
FINISHEDs IT CALLS KILL» PASSING IT THE ADDRESS OF THE STACKs. IF THE 
STACK WAS OBTAINED BY GETSPACE IT IS RETURNEDe IF THE STACK IS PART 
OF THE STACK QUEUEs IT IS LINKED INTO THE FRONT OF THE QUEUE, ITS 
MURDEROUS TASK COMPLETE» KILL GOES TN NOTHINGTODO, 
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THE BEDS SLEEPING AND WAKING 


enter em ET SOI ARR RR SA STEN 


THE BED IS A LINKED LIST OF CONTROL LINES» ENTRIES TO WHICH ARE MADE 
BY SLEEP, JOBS ARE PUT TO SLEEP TO WAIT FOR AN EXOGENOUS EVENT TO 
OCCUR = FOR EXAMPLE» AN I/O OPERATION TO FINISH» A TOGGLE TO BE 
RELEASED» OR A GIVEN LENGTH OF TIME TO PASS» CLEARING OF INTERRUPTS 
CSLEEPC1s1)) AND EUTHANASIA (SLEEP(00)) ARE ALSO POSSIBLE. THE THO 
PARAMETERS PASSED TO SLEEP ARE A DESCRIPTOR» POINTING TO THE WORD TO 
BE TESTED AND A MASK TO TEST IT WITHe THE JOB IS AWAKENED IF ANY OF 
THE BITS WHICH ARE ON IN THE MASK ARE ALSO ON IN THE TEST WORD, IN 
ADDITION» THERE IS A VARIABLE» CLICKs IN WHICH A PROCEDURE CAN STORE 
A TIME OUT VALUE. IF THIS IS DONE» THE PROCEDURE WILL BE AWAKENED 
WHEN THE ACTUAL TIME EXCEEDS THE TIME OUT VALUE. IF IT IS NOT DONEs 
A VALUE OF 316145143832.25 IS USED. WHICH» IN EFFECTs ELIMINATES THE 
TESTs AS ANOTHER VARIATIONs A PROCEDURE CAN PASS A BOOLEAN EXPRESSION 


TO COMPLEXSLEEP AND SLEEP UNTIL IT IS TRUE. 


THE BED ENTRY FOR A PARTICULAR JOB IS KEPT IN THAT JOBS STACK, THE 


TWO PARAMETERS ARE SIMPLY LEFT IN THE STACK AND CONTAIN THE FOLLOWING 


INFORMATIONS 
PARAMETER 1 DESCRIPTOR POINTING TO THE WORD TO BE TESTED 
OR A 1 IF THIS ENTRY COMES FROM COMPLEX SLEEP. 
PARAMETER 2 MASK OR ACCIDENTAL ENTRY PROGRAM DESCRIPTOR 


FOR COMPLEXSLEEP ENTRIESs 


THEY ARE FOLLOWED BY THE RCW AND THEN SIX MORE WORDS ADDED BY SLEEP» 


WHICH CONTAINS 
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WORD O 281 i 
939 777 COCTAL) 
18:15 PRIORITY + 64 
33215 ADDRESS OF FIRST WORD ABOVE RCW IN THE NEXT 


ENTRY. 
WORD 2 MIX INDEX ASSOCIATED WITH THIS ENTRY, 
WORD 3 TIME OUT VALUE 
WORD 4 LOGLINE 
WORD 5 F REGISTER SETTING OF THE SLEEP ROUTINE WHEN IT 


MADE THE ENTRY CPOINTS TO THE RCW). 


THE HEAD AND TAIL OF THE QUEUE ARE KEPT IN BED AND BED{ WHICH HAVE 
THE FGRMATS OF THE FORWARD AND BACK LINKS CWORDS 0 AND 1 ABOVE) 
RESPECTIVELY. THE PRIORITY FIELD OF RED IS 77777 COCTAL)I. THE ENTRIES 
70 THE BED ARE ORDERED BY PRIORITY AND ARE FIRST*IN FIRST*OUT AMONG 
ENTRIES OF EQUAL PRIORITY, THE BACK LINK OF THE FIRST ENTRY AND THE 


FORWARD LINK CF THE LAST ENTRY BOTH POINT TO BED. 


THE WORDS ABOVE THE RCW ARE NORMALLY REFERENCED AS AN ARRAYe THE BACK 
LINK OF AN ENTRY MAY BE USED TO ACCESS THE PRECEDING ENTRY AS A SINGLY 
DIMENSIONED ARRAY AND THE FOLLOWING ENTRY AS A DOUBLY DIMENSTONED 
ARRAY, THIS MAKES THE LINKING AND DELINKING OF AN ENTRY EXTREMELY 


SIMPLE. 


JOBS ARE AWAKENED BY NOTHINGTONOs WHICH GOES TO THE BEO AFTER PROCESSNG 
THE FORK QUEUEe IT LINKS THROUGH THE BEDs DOING AN INTERROGATE 


INTERRUPTS BEFORE PROCESSING ANY ENTRY» AND THEN SETTING THE S REGISTER 
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TO THE TOP OF THE ENTRY AND THE F REGISTER TO THE RCW, IF THE ENTRY 


PASSES THE TESTS» IT IS DELINKED AND INITIATED VIA AN EXIT OPERATION. 


IF IT DOES NOT PASS» THE NEXT ENTRY IS TESTED. 
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ASSIGNING JOBS TO CORE 


THE AREA ABOVE THE FENCE IS DIVIDED INTO CHUNKS OF 1024 WORDS, WHEN 

A PROGRAM ENTERS THE MIX IT IS ASSIGNED A SEY OF CONTIGUQUS CHUNKS 

IN WHICH TO RUN, THE NUMBER OF CHUNKS REQUIRED IS CALCULATED FROM THE 
ESTIMATE SUPPLIED BY THE COMPILERe ONCE A JOB HAS BEEN ASSIGNED TO 

AN AREAs IT IS ALWAYS RUN WITHIN THAT AREA, 


THE AREA IN WHICH A JOB RUNS IS DIVIDED INTO MEMORY LINKS EXACTLY AS 
IT IT WERE ALL OF CORE ON THE STANDARD SYSTEMe WHEN GETSPACE AND 
FORGETSPACE ARE CALLED» THEY ARE GIVEN THE MIX INDEX OF THE JOB» WHICH 
THEY USE TO FIND THE AREA WITHIN WHICH SPACE NEEDS TO BE GOTTEN OR 
RETURNED. THUS» WHILE A JOB IS RUNNINGs ITS STORAGE CAN BE OVERLAID 

OR MADE PRESENT IN THE STANDARD WAY, THE DIFFERENCE IS THAT IT IS 
CONFINED TO RUN IN A GIVEN AREA AND THAT NO OTHER PROGRAM CAN USE ANY 


OF THAT AREA, 


SINCE A JOB ALWAYS OCCUPIES THE SAME AREAs NON*OVERLAYABLE STORAGE, 
SUCH AS THE PRT» CAN BE SWAPPEDS THAT ISs IT CAN BE ROLLED OUT AND 
THEN ROLLED IN WITH THE REST OF THE PROGRAM, OF COURSE» SINCE IT IS 


NON*@OVERLAYABLE» IT REMAINS IN CORE WHENEVER THE PROGRAM IS IN CORE. 


THE ALGORITHM FOR ASSIGNING A PROGRAM TO AN AREA ATTEMPTS TO MINIMIZE 
THE CONFLICT FOR SPACE BETWEEN THAT PROGRAM AND THE OTHER PROGRAMS 

IN THE MIXe TO O00 THISs IT EXAMINES EACH POTENTIAL AREA» IeEs EACH 
SET OF THE NECESSARY NUMBER OF CONTIGUOUS CHUNKS» AND CAECULATES Ts 
THE MAXIMUM NUMBER OF USERS OF ANY ONE CHUNK WITHIN THE AREA, THE JOB 
TS ASSIGNED TO THE AREA WITH THE MINIMUM Ts AND INTO THE AREA LOWEST 


IN CORE AMONG AREAS WITH EQUAL Te 
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SWAPPING 


ONE OF THE GOALS OF THE TIME SHARING SYSTEM IS TO MAINTAIN EFFICIENT 
USE OF CORE WHILE ENSURING A QUICK RESPONSE TO EVERY USER, THIS IS 
DONE BY PERIODICALLY ROLLING JOBS OUT OF CORE TO MAKE ROOM FOR OTHER 
JOBS. THERE ARE THREE REASONS FOR WHICH A JOB MAY BE ROLLED OUT WHILE 
IT IS RUNNING, | 


FIRST» EACH JOB IS ASSIGNED A TIME SLICE WHEN IT IS ROLLED IN, 
THIS TIME SLICE VARIES DEPENDING ON THE JOBS SIZE AND PRIORITY 
AND ON THE LENGTH OF TIME IT HAS BEEN RUNNINGe WHEN A JOB HAS 
USED ITS ALLOTTED TIME SLICEs IT 1S SWAPPED OUT. 


SECONDs A JOB IS SWAPPED QUT IF THE OPERATOR STOPS IT WITH AN 

ST MESSAGE OR IF IT HAS TO WAIT FOR TELETYPE I/O» WHICH IS 
EXTREMELY SLOW RELATIVE TO THE COMPUTERs IT SHOULD BE NOTED THAT 
ON INPUT THE USER IS ALLOWED TO TYPE AHEAD OF HIS JOB» WHICH IS” 
NOT SWAPPED OUT UNTIL IT HAS TO WAIT FOR DATA. ON OUTPUT» BEFORE 
IT IS ROLLED OUT» THE USERS PROGRAM IS ALLOWED TO FILL A TANK 
WHICH HOLDS APPROXIMATELY. 10 MINUTES OF OUTPUT. 


THIRD» WHEN A NEW JOB ENTERS THE SYSTEMs OR WHEN A JOB WHICH HAS 
BEEN WAITING FOR TELETYPE I/0 RETURNS TO THE SYSTEMs AN ATTEMPT 

IS MADE TO GIVE IT AN IMMEDIATE TIME SLICEs THIS MEANS THAT JOBS 
ALREADY RUNNING MAY HAVE TO BE SWAPPED OUT, JOBS WHICH ARE SWAPPED 
QUT FOR THIS REASON ARE SWAPPED BACK IN AHEAD OF JOBS WHICH HAD 
USED THEIR FULL TIME SLICE, 


NEW ANDO REENTERING JOBS ARE ALLOWED IMMEDIATE ACCESS TO CORE IN ORDER 
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TO GIVE THEM A CHANCE TO SEND A RESPONSE 7O THE USER, SINCE THEIR 
FIRST TIME SLICE IS REALTIVELY SMALL» THEY ARE QUICKLY SWAPPED OUT» 
SO THAT OTHER USERS SUFFER ONLY A NEGLIGIBLE DELAYe THIS IMMEDIATE 
ACCESS IS ESPECIALLY VALUABLE TO PROGRAMS THAT GENERATE A GREAT DEAL 
OF OUTPUT IN A RELATIVELY SHORT TIME» SUCH AS THE LIST PROGRAM FOR 


CANDE. 


THE PROCEDURES WHICH HANDLE THE ACTUAL SWAPPING OPERATE ON JOBS PLACED 
IN THE SWAP QUEUE BY THE OTHER PARTS OF THE MCP, IF A JOB IN THE SWAP 
QUEUE NEEDS TO BE SWAPPED OUT, IT IS DEALT WITH IMMEDIATELYs BUT IF 
IT IS READY TO BE SWAPPED IN» IT IS PLACED IN THE READY QUEUE» WHICH 


TS USED TO HOLO JOBS WAITING TO BE SWAPPED IN. 


WHEN A JOB IS SWAPPED OUT» ITS AREA BECOMES AVAILABLE AND SO THE 
CHUNKS WITHIN IT ARE ASSIGNED TO THE JOBS HIGHEST IN THE READY QUEUE 
WHICH REQUIRE THEM, THE CHUNKS THUS ASSIGNED ARE SAID TQ BE POSSESSED 
BY THE JOB TO WHICH THEY ARE ASSIGNED, WHEN A JOB POSSESSES A CHUNK» 
IT PREVENTS ALL OTHER JOBS FROM USING THAT CHUNK. AS A JOB SITS IN 
THE READY QUEUE IT ACCUMULATES CORE UNTIL IT POSSESSES THE AREA IT 
NEEDSe THEN IT IS SWAPPED IN AND ALLOWED TO RUN» WHEN IT IS SWAPPED 
OuT IY LOSES POSSESSION OF IETS CHUNKSs WHICH ARE REASSIGNED TQ OTHER 


JOBS IN THE QUEUE, 


THE EFFECT OF THIS IS THAT A JOB IN THE READY QUEUE CANNOT BE RUN IF 
ANY JOB ABOVE IT IN THE QUEUE REQUIRES ANY OF ITS CHUNKS, CONVERSELY» 
A JOB IN THE QUEUE IS RUN AHEAD OF ANY JOBS BELOW IT IN THE QUEUE 

WHICH REQUIRE A PART OF ITS AREAe THIS ENSURES EVERY JOB A CHANCE TO 


RUN NO MATTER WOW LARGE IT IS OR LOW ITS PRIORITY, 
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THERE ARE THREE ENTRY POINTS TO THE READY QUEUE. THEY ARE? 


1) READYENDs INTO WHICH ARE PLACED NEW JOBS» JOBS WHICH HAVE 
WAITED FOR TELETYPE I/O» AND JOBS WHICH HAVE BEEN OK*ED AFTER 
BEING STOPPED, 

2) FORCEND» INTO WHICH ARE PLACED JOBS WHICH ARE FORCED OUT 
BY JOBS AT READYEND, 

3) RDYRPTENDs INTO WHICH JOBS WHICH HAVE USED THEIR TIME SLICE 
ARE PLACED, 


WHEN A JOB IS PLACED AT READYEND OR FORCEND» IT IS BEING PLACED IN 
FRONT OF OTHER JOBS IN THE QUEUE, IT IS THEREFORE ALLOWED TO TAKE 
CHUNKS FROM THE JOBS BELOW IT, THAT IS» IF A JOB BELOW THE NEN ENTRY ~ 
TO THE QUEUE POSSESSES A CHUNK NEEDED BY THE NEW ENTRY» THAT CHUNK 

IS REASSIGNED TO THE NEW ENTRY, THUS» CHUNKS ARE ALWAYS POSSESSED BY 
THE HIGHEST JOB IN THE QUEUE WHICH CAN USE THEM, 


FUTHERMOREs WHEN A JOB IS PLACED AT READYEND IT FORCES yOBS WHICH ARE 
USING CHUNKS IN ITS AREA OUT OF COREs PROVIDED THAT THOSE JOBS DID 

NOT THEMSELVES ENTER THE QUEUE AT READYEND. WHEN THE FORCED OUT JOB 

IS ACTUALLY SWAPPED OUT» ITS CHUNKS ARE REASSIGNED» ANDs SINCE READYEND 
IS THE HIGHEST ENTRY POINT INTO THE QUEUE» JOBS AT READYEND GET THE 
CHUNKS THEY NEEDs IN THIS WAYs UNLESS PART OF THEIR AREA IS POSSESSED 
BY OTHER JOBS GETTING THEIR INITIAL TIME SLICEs JOBS WHICH ENTER AT 
READYEND GAIN POSSESSION OF THEIR AREA ALMOST IMMEDIATELY, 


IT SHOULD BE NOTED THAT THE PRIORITY OF A JOB IS NOT A FACTOR IN THIS 


ALGORITHM, ALL JOBS» REGARDLESS OF THEIR PRIORITYs GET A TURN ON THE 
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SYSTEMe HOWEVER» THE PRIORITY OF A JOB DOES AFFECT THE LENGTH OF ITS 


TIME SLICE. THE LENGTH OF THE TIME SLICE IS ALSO AFFECTED RY THE 
NUMBER OF TIMES THE JOB HAS BEEN SWAPPED SINCE ITS LAST INTERACTIONs 


TeEes SINCE IT WAS LAST PUT AT READYEND. 
THE FORMULA FOR COMPUTING THE TIME SLICE IS 


T= (1+ N + (9"P)/4 + C/4000) x 64 


WHERE 
T IS THE PROCESSOR TIME LIMIT IN SIXTIETHS OF A SECOND, 
N IS THE NUMBER OF TIMES THE JNB HAS BEEN SWAPPED SINCE ITS 


LAST INTERACTION, 
P IS THE PRIORITY OF THE JOB, 


C IS THE NUMBER OF WORDS OF CORE REQUIRED FOR THE JOB, 


THE VARIABLE» N» IS NOT ALLOWED TO EXCEED SEVEN. THUS» ONCE A JOB HAS 
BEEN SWAPPED SEVEN TIMES» ITS TIME SLICE HAS REACHED THE MAXIMUM AND 


IS NO LONGER INCREASED BY FURTHER SWAPPING. 


A JOB IS ALSO GIVEN AN ELAPSED TIME LIMIT OF ONE AND A HALF TIMES ITS 


PROCESSOR TIME LIMIT, IF IT EXCEEDS EITHER OF THESE LIMITS» IT IS 


SWAPPED OUT AND PLACED IN THE READY QUEUE AT ROYRPTEND. 


IN SUMMARY» THE REASONS FOR WHICH A JOB CAN BE PLACED IN THE SWAP 


QUEUE AND THE ACTIONS TAKEN AS A RESULT ARES 


1) BEGINNING OF JOB. THE JOB IS PLACED IN THE READY QUEUE AT 


READYEND 
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2) END OF JOB, THE CHUNKS POSSESSED BY THE JOB ARE REASSIGNED 
TO JOBS IN THE READY QUEUE, 

3) WAIT FOR EXTERNAL CONDITION. THE JOB IS SWAPPED OUT AND ITS 
CHUNKS ARE REASSIGNEDs 

4) EXTERNAL CONDITION SATISFIED, THE JOB IS ADDED TO THE READY 
QUEUE AT READYEND, 

5) FORCE OUT, THE JOB IS ADDED TO THE READY QUEUE AT FORCEND 
AND THEN JTS CHUNKS ARE REASSIGNED, 

6) END OF TIME SLICE, THE JOB IS ADDED TO THE READY QUEUE AT 
RDYRPTEND AND THEN ITS CHUNKS ARE REASSIGNEDs 


NOTE THAT JOBS WHICH ARE FORCED OUT OR WHICH HAVE USED THEIR TIME 
SLICE ARE ADDED TO THE QUEUE BEFORE THEIR CHUNKS ARE REASSIGNED. THIS 
MAKES IT POSSIBLE FOR THEM TO GET THEIR CHUNKS BACK IF NO OTHER JOBS 
CAN USE THEM, | 
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FROM THE TIME IT ENTERS THE MIX UNTIL THE TIME IT LEAVES, 


SWAPPING STATUSES 


EACH JOB 


HAS A STATUS ASSOCIATED WITH IT, THE STATUSES SPECIFY WHAT YHE JOB 


IS DOING AT ANY GIVEN TIME, 


10 


ii 


16 


32 


TIMEND 


WAITSWAP 


BOJSTATE 


SATISFY 


EOUSTATE 


FORCESWAP 


TRANSIT 


WAITSTATE 
READYSTATE 
RDYPPT 
READYB 


RUNNING 


SELECTING 


THE STATUSES ARES 


THE JOB IS WAITING TO BE SWAPPED OUT AFTER USING 
ITS TIME SLICE. 

THE JOB IS WAITING TO BE SWAPPED OUT TO WAIT FOR 
AN EXTERNAL CONDITION. 

NEW JOB WAITING TO BE ADDED TO READY QUE. 

THE JOB IS WAITING TO BE ADDED TO THE READY QUE 
AFTER AN EXTERNAL CONDITION HAS BEEN SATISFIED. 
THE JOB HAS REACHED COMPLETION AND IS WAITING TO 
HAVE ITS CHUNKS REASSIGNED. 

THE JOB IS WAITING TO BE SWAPPED GUT DUE TO A 
FORCE OUT, 

THE JOB IS BEING SWAPPED IN OR GUT, 

THE JOB HAS BEEN SWAPPED OUT ON DISK AND IS 
WAITNG FOR AN EXTERNAL CONDITION. 

JOB IS IN THE READY QUEUE AFTER WAITING FOR AN 
EXTERNAL CONDITION. 

JOB IS IN THE READY QUELE AFTER BEING FORCED OUT 
OR AFTER USING ITS TIME SLICE. 

NEW JOB IN THE READY QUEUE 

JOB IS IN CORE. 


NEW JOB BEING PROCESSED AFTER GAINING POSSESSION 
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OF ALL OF ITS CHUNKS, 
56 7 STABLE JOB HAS LOST ITS CHUNKS AFTER AN END OF JOB» 


ALSO USED TO MASK FOR ALL STATUSES BELOW 7. 


NOTE THAT STATUSES 0 = 5 APPLY TO JOBS IN THE SWAP QUEUE AND STATUSES 


9 = 11 APPLY TO JOBS IN THE READY QUEUE. 
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THE SWAPPING PROCEDURES 
THE PROCEDURES WHICH DEAL WITH SWAPPING ARES 


INITIALSWAP ASSIGNS AN AREA TO A JOB» SETS UP MEMORY LINKS 
AND GETS A SWAP AREA ON DISK. 
SWAP ENTERS A JOB IN THE SWAP QUEUE AND GIVES IT THE 
APPROPRIATE STATUS, 
BRINGBACK CALLED TO ENTER A JOB IN THE SWAP QUEUE AFTER 
THE EXTERNAL CONDITION FOR WHICH IT HAS BEEN 
WAITING IS SATISFIED. 
SWAPPER HANDLES THE ACTUAL SWAPPING, 
SWAPPINGIO DOES I/0 FOR SWAPPER, 
UNHOOKANDWAIT DISCONNECTS A JOB ABOUT TO BE SWAPPED QUT. 
HOOKUPMCP RECONNECTS A JOB THAT HAS BEEN SWAPPED. IN. 
REENTER USED BY HOOKUPMCP, 


WHEN IT FINDS A JOB IN THE SWAP QUEUE» SWAPPER USES ITS STATUS TN 
DETERMINE WHAT ACTION TO TAKEs AND THEN DEALS WITH IT AS DESCRIBED 
UNDER "SWAPPINGs"” IF THE JOS REQUIRES SWAPPING OUT» SWAPPER CALLS 
UNHOOKANDWAIT WHICH STORES THE LOCATION OF THE TOP UF THE PROGRAMS 
STACKs DELINKS THE BED ENTRY FOR THE JOB, REMOVES THE JOB FROM THE 
MCP AND INTRINSIC TABLES AND THEN SLEEPS UNTIL ALL I/O FOR THE JOB 
IS COMPLETE. SWAPPER THEN CALLS SWAPPINGIO AND THE JOB IS WRITTEN 
INTO THE AREA RESERVED FOR IT ON DISK, IF APPROPRIATE, THE JOB IS 
LINKED INTO THE READY QUEUE AND THEN ITS CHUNKS ARE REASSIGNED ONE 
AT A TIME, AS SOON AS A JOB HAS GAINED POSSESSION OF ITS ENTIRE AREA, 
IT IS SWAPPED IN» AND THEN CHUNK REASSIGNMENT CONTINUES, 
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TO SWAP A JOB IN» SWAPPER FIRST CALLS SWAPPINGIO TO READ THE JOB BACK 
INTO CORE AND THEN HOOKUPMCP, WHICH IN TURN CALLS FOR REENTER TO RUN 
INDEPENDENTLY AND THEN SLEEPS UNTIL REENTER HAS RUNe REENTER SETS THE 
S AND F REGISTERS TO THE TOP OF THE JOBS STACK AND THEN TRANSFERS Cle 
Es NOT A CALL) TO SLEEPs WHICH WILL USE THE S AND F REGISTERS TO MAKE 
A BED ENTRY FOR THE JOBe SINCE THE BED ENTRY FOR HOOKUPMCP PRECEDES 
THE ONE FOR THE JOB» HOOKUPMCP IS AWAKENED IN TIME TO PUT THE JOB 
BACK INTO THE MCP TABLESe IT THEN RETURNS TO SWAPPER WHICH CONTINUES 
TO REASSIGN CHUNKS, AFTER PROCESSING ALL THE AVAILABLE CHUNKS» IT 
GOES TO THE NEXT JOB IN THE SWAP QUEUE» OR» IF THE SWAP QUEUE IS EMPTYs> 
COMMITS SUICIDE BY CALLING KILL. EVENTUALLY» AS THE MCP PROCESSES THE 
BED» IT WILL FIND THE JOB AND RESTART IT AS IF IT HAD NEVER BEEN 


SWAPPED. 


WHEN OTHER PROCEDURES IN THE MCP OISCOVER THAT A JOB NEEDS TO BE 
SWAPPED» THEY CALL BRINGBACK IF THE JOB IS SWAPPED OUT AND CAN NOW 

BE SWAPPED BACK IN AND SWAP FOR ALL OTHER CASESe THESE ROUTINES LINK 
THE JOB INTO THE SWAP QUEUE AND CHECK TO SEE IF SWAPPER IS DEAD OR 
ALIVE. IF IT IS DEAD» IT IS REINCARNATED AS AN INDEPENDENT RUNNER AND 
MARKED AS BEING ALIVEs THIS ALLOWS SWAPPER TO BE OVERLAID WHEN IT HAS 


NOTHING TO OO, 


WHEN A JOB ENTERS THE MIXs THE SELECTRUN PROCEDURE» THE EQUIVALENT 
OF THE SELECTION PROCEDURE IN THE STANDARD MCPs IS CALLED AS DESCRIBED 
IN THE NARRATIVE DESCRIPTION OF THE DFMCP» BUT» INSTEAD OF CALLING 
GETSPACEs SELECTRUN CALLS INITIALSWAPs WHICH ASSIGNS THE JOB TO AN 


AREA» CALLS SWAP TO QUEVE IT INTO THE SWAP QUEUE» AND THEN SLEEPS 
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UNTIL THE JOB HAS GAINED POSSESSION OF ITS AREA, WHEN A NEW JOB 


ACCUMULATES ALL OF ITS CHUNKS» SWAPPER REMOVES IT FROM THE READY QUEUE 
AND GIVES IT THE STATUS SELECTING. THIS AWAKENS INITIALSWAP SQ THAT 

IT CAN SET UP THE MEMORY LINKS AND GET A SWAP AREA ON DISKe IT THEN 
RETURNS TO SELECTRUN WHICH PROCEEDS TO INITIATE THE JOB IN THE USUAL 


WAY. 
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EXPANDING AN AREA 


ALTHOUGH THE CORE AREA INITIALLY ASSIGNED TO A JOB WILL ORDINARILY 
BE SUFFICIENT» CASES CAN ARISE IN WHICH A JOB NEEDS MORE SPACE, THIS 
CONDITION SHOWS UP WHEN GETSPACE IS UNABLE TO OBTAIN ENOUGH SPACE TO 
SATISFY A REQUEST. IN THAT CASE» IF THE JOB IS NOT ALREADY ASSIGNED 
TO THE ENTIRE AREA ABOVE THE FENCE» GETSPACE WILL INITIATE AN EXPANSION 
OF ITS AREA BY CALLING SWAP TO FORCE THE JOB OUT CIeE, THE JOB WILL 
ENTER THE READY QUEVE AT FORCEND) AND THEN SLEEP UNTIL THE JOB IS 
AGAIN RUNNINGs AT WHICH TIME IT WILL HAVE AN EXTRA CHUNK AND GETSPACE 
CAN TRY AGAIN, THIS IS REPEATED UNTIL SUFFICIENT SPACE IS OBTAINED 

QR UNTL THE JOB IS ASSIGNED THE MAXIMUM NUMBER OF CHUNKS. WHEN A JOB 
RUNS OUT OF SPACE AND NO CORE ITS AVAILABLE FOR EXPANSIONs GETSPACE 
SLEEPS AND THEN TRIES AGAINe IF SPACE IS NOT AVAILABLE ON THE THIRD 


TRY» THE JOB IS TERMINATED, 


DURING THE SWAPPING OF A JOB WHICH IS BEING EXPANDED» SWAPPINGIO CALLS 
EXPANDER, WHEN THE JOB IS BEING SWAPPED OUT» EXPANDER CHOOSES THE 
DIRECTION IN WHICH THE JOBS AREA SHOULD BE EXPANDED IN ORDER TO 
MINIMIZE CONFLICT WITH OTHER JOBS» CHANGES SC OR LC ACCORDINGLY AND 
EXITSe THE JOB THEN SITS IN THE READY QUEUE UNTIL IT POSSESSES ITS 
AREAs WHICH IS NOW ONE CHUNK LARGER THAN IT WAS. WHEN THE JOB IS 
SWAPPED IN» EXPANDER IS CALLED AGAIN, IT SETS UP THE MEMORY LINKS TO 
INCLUDE THE NEW AREA AND» IF THE JOB WAS ADDED IN FRONT» THE JAR AND 


UV TABLE ENTRIES FOR THE JOB ARE MOVED TO THE FRONT OF THE NEW AREAS 
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LINE MAINTENANCE 


ONE OF THE PROBLEMS FACING ANY TIME SHARING SYSTEM IS THAT PEOPLE AND 
TELETYPES HAVE 1/0 REQUIREMENTS THAT ARE QUITE DIFFERENT FROM THNSE 

OF COMPUTERS, THE REMOTE USERS MUST BE ABLE TO TRANSMIT AND RECEIVE 

A RELATIVELY SLOW BUT STEADY STREAM OF INFORMATIONs WHEREAS PROGRAMS 
REQUIRE SHORT BURSTS OF MUCH FASTER I/0. IN THE 85500 TIME SHARING 
SYSTEM THE NEEOS OF BOTH THE USER ANN THE PROGRAM ARE MET BY PERFORMING 
THEIR 1/0 INDEPENDENTLYe IN ORDER TO DO THIS AS EFFICIENTLY AS POSSIBLEs 


BOTH INPUT AND OUTPUT MAKE USE OF QUEUEING STRUCTURES AND DISK TANKS. 


AS DATA COMES IN FROM A TELETYPEs IT IS COLLECTED IN 28 CHARACTER 
BUFFERS IN THE OTTU,. WHEN A BUFFER ITS FULL IT IS READ INTO A SEGMENTED 
SAVE AREA AND LINKED TO ANY OTHER BUFFERS WHICH ARE PART OF THE SAME 
MESSAGE. THE COMPLETE MESSAGE» AS INDICATED BY A GROUP MARK» IS THEN 
LINKED INTO THE WORKER QUEUEs WHICH CONSISTS OF BUFFERS LINKED BY THE 
FIRST WORDs WHERE | 


232 SPECIFIES THE SIZE OF THE AREA 

431 IS THE END OF MESSAGE FLAG», INDICATING THAT THIS IS THE 
LAST BUFFER OF A MESSAGE 

71 IS USED TO IDENTIFY THE SPECIAL MESSAGE WHICH MARKS THE 
OCCURRENCE OF A DISCONNECT, 

9:1 IS THE END OF QUEVE FLAG, 

1038 IS THE LOGICAL LINE NUMBER 

18:15 CONTAINS THE ADRESS OF THE PREVIOUS BUFFER IN THIS 


MESSAGE OR ZERO IF THIS IS THE FIRST BUFFER, 


i is a 


33315 CONTAINS THE ADDRESS OF THE NEXT BUFFER IN THE QUEUE OR 


ZERO IF THIS IS THE LAST BUFFER. 


THE ADDRESSES OF THE HEAD AND TAIL OF THE QUEUE ARE KEPT IN WORKERING,. 
NOTE FHAT BUFFERS ARE LINKED BACK ONLY TO A MESSAGE BOUNDARY» BUT ARE 
LINKED FORWARD ACROSS MESSAGE BOUNDARIES, 


THE BUFFERS IN THE WORKER QUEUE ARE CONSOLIDATED INTO MESSAGES AND 
THEN STORED IN THE APPROPRIATE DISK TANK, INPUT FROM ALL USERS TO 
CANDE IS STORED IN A TANK WHICH CONSISTS OF CHUNKS CONTAINING 
TANKCHUNKSIZE (CURRENTLY 256) SEGMENTS OF USER DISKe THE MCP OBTAINS 
ADDITIONAL CHUNKS AS THEY ARE NEEDED ANO CANDE RETURNS THE CHUNKS 
WHEN IT IS THROUGH WITH THEM, WHEN A SEGMENT IS WRITTEN ON DISKs IT 
IS ALSO LEFT IM CORE UNTIL CANDE HAS DONE ITS INITIAL SCANNING. THE 
FORMAT OF A SEGMENT ON DISK IS 


WORD 0 3315 RELATIVE DISK ADDRESS WITHIN THIS CHUNK 
18815 CORE ADDRESS OF NEXT SEGMENT 
40:8 NUMBER OF WORDS OF DATA IN THIS SEGMENT 
WORDS 1°29 MESSAGES 


IN ADDITIONs IN CORE TWO FURTHER WORDS ARE USED, 


WORD =} DECIMAL DISK ADDRESS OF THE SEGMENT. 


— WORD #2 1/0 DESCRIPTOR USED TO WRITE IT ONTO DISK 


EACH MESSAGE CONSISTS OF ONE INFORMATION WORD PLUS AS MANY WORDS AS 


ARE REQUIRED TO HOLD ITe THE FORMAT OF THE INFORMATION WORD I1S8 


isi SPECIAL MESSAGE FLAG 
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1038 LOGICAL LINE NUMBER 


4038 NUMBER OF CHARACTERS IN MESSAGE 


THE CORE AND DISK ADDRESSES OF A SEGMENT ARE THEN PASSED TO CANDE IN 


A DATA EVENT, 


WHEN THE USER ENTERS DATA FROM A PAPER TAPEs IT IS STORED IN A TANK 

FILE CREATED FOR THE LINE BY THE TAPE COMMANDe THIS FILE IS SET UP 
FXACTLY LIKE THE CANDE TANKS3 THAT IS» IT CONTAINS ROWS OF TANKCHUNKSIZE 
SEGMENTS AND THE SEGMENTS» BOTH IN CORE AND ON DISK» HAVE THE FORMAT 
DESCRIBED ABOVE. HOWEVER» FUR PAPERTAPE THE SEGMENTS IN CORE ARE USED 


ONLY AS BUFFERS AND THEIR CONTENTS ARE NOT FURTHER SAVED. 


IF THE USER IS CONNECTED TO A USER PROGRAMs HIS DATA IS STORED ACCORDING 
TO THE MIX INDEX OF THE PROGRAM, THE DISK AREA FOR THIS» WHICH IS 

GOTTEN DURING INITIALIZATION» CONTAINS CLUMPSIZEXMIXMAX SEGMENTS» 

THUS ALLOWING CLUMPSIZE CCURRENTLY 16) SEGMENTS TO EACH USER, THE 
ADDRESS OF THE SASE OF THIS AREA IS KEPT IN PROGTANK AND A USER USES 

THE AREA BEGINNING AT RELATIVE SEGMENT CLUMPSIZEXMIX, THE TANK FOR 

ANY GIVEN JOB IS USED CYCLICALLY. WHEN A PROGRAM ASKS FOR DATA IT IS 


READ OFF OF THE DISK AND INTO BUFFERS IN THE PROGRAMS AREA. 


OUTPUT DATA FOR A GIVEN LINE IS NORMALLY STORED IN THE OUTPUT TANK 

FOR THAT LINE, THE OUTPUT TANKS ARE KEPT IN A DISK AREA OF LMAXx 
GLOMSIZE SEGMENTS WHICH IS OBTAINED DURING INITIALIZATION. (CURRENTLY, 
GLOMSIZE IS 32.6) THE AREA FOR A SPECIFIC LINE BEGINS AT GLOMSIZEXLL» 
WHERE LL IS THE LINE NUMBERe MESSAGES FROM CANDE AND THE MCP ARE 


WRITTEN DIRECTLY INTO A SEGMENT WITHOUT BEING PACKEDs BUT MESSAGES 
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FROM PROGRAMS RUNNING ABOVE THE FENCE ARE PACKED INTO A 30 WORD ARRAY 
WITHIN THAT PROGRAMS AREA» AND THEN WRITTEN ONTO DISK AS A FULL SEGMENT. 
THE FIRST WORD OF ANY SEGMENT CONTAINS THE NUMBER OF CHARACTERS IN 

THE SEGMENT AND THE REMAINING 29 WORDS CONTAIN OUTPUT WITH A SINGLE 
GROUP MARK AT THE ENDe WHEN A JOB IS SWAPPED OUT OR WHEN AN ARRAY 

GETS FULL CIeEe THE NEXT MESSAGE REQUIRES MORE SPACE THAN IS LEFTY IN 


THE ARRAY) IT IS WRITTEN ONTO THE DISK, 


THE PROCEDURE WHICH PERFORMS THE ACTUAL OUTPUT OF INFORMATION TAKES 
DATA FOR A GIVEN LINE FROM THAT LINE*S LINE QUEUE. WHEN THE LINE QUEUE 
IS EMPTYs DATA IS TAKEN FROM THE TANK 56 CHARACTERS AT A TIME AND 
ADDED TO THE LINE QUEUE. OUTPUT DATA IS ADDED DIRECTLY TO THE LINE 


QUEVE ONLY IF BOTH THE TANK AND THE LINE QUEUE ARE EMPTY, 


THE LINE QUEVE FOR A GIVEN LINE CONSISTS OF BUFFERS WHICH ARE THE 
CORRECT SIZE FOR THE ADAPTER ON THAT LINEs THEY ARE STORED IN SEGMENTED 


SAVE AREAS AND ARE LINKED BY AN INFORMATION WORD WHICH HAS THE FORMAT 


431 END OF MESSAGE FLAG 

1038 LOGICAL LINE NUMBER 

18815 ADORESS OF PREVIOUS ENTRY IN THE LINE QUEUE OR ZERO IF 
THIS IS THE FIRST ENTRY, 

33:15 ADDRESS OF THE NEXT ENTRY IN THE LINE QUEUE OR ZERO IF 


THIS 1S THE LAST ENTRY, 


THE ADORESS OF THE HEAD AND TAIL OF THE LINE QUEUE FOR LINE I IS KEPT 
IN ODCREQUESTCIJ« OCREQUEST IS ALSO USED TO KEEP THE READY QUEUEs A 


LINKED LIST OF LINES WHICH HAVE I/0"S (DATA TO BE WRITTENs BLAST READS 
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OR ACTIVE INTERROGATES) READY FOR OUTPUT IN THEIR LINE QUEUES. THE 


FORMAT OF AN ENTRY IN DCREQUEST IS 


1:9 STATUS OF THE LINE, 

10:8 LINE NUMBER OF THE NEXT LINE IN THE READY QUEUE OR ZERO 
IF THIS LINE IS NOT IN THE READY QUEUE OR IS THE LAST 
LINE IN THE READY QUEUE. 

18:15 ADDRESS OF THE TAIL OF THE LINE QUEUE OR ZERO IF THE LINE 
QUEUE IS EMPTY. 

33815 ADDRESS OF THE HEAD OF THE LINE QUEUE OR ZERO IF THE LINE 


QUEUE IS EMPTY. 


THE LINE NUMBERS OF THE HEAD AND TAIL OF THE READY QUEUE ARE KEPT IN 


DCREQUEST(0],. 
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LINE MAINTENANCE PROCEDURES 


THE MCP PROCEDURES THAT PERFORM LINE MAINTENANCE CAN BE ROUGHLY DIVIDED 
INTO THREE GROUPS, THE PROCEDURES IN THE FIRST GROUP SERVICE THE 
TERMINAL UNIT BUFFERS AND OPERATE PRIMARILY AS A PART OF IOFINISH, 

THE PROCEDURES IN THE THIRD GROUP INTERFACE DIRECTLY WITH THE NORMAL 
STATE PROGRAMS AND ARE MOSTLY CALLED VIA COMMUNICATES, THE SECOND 

GROUP OF PROCEDURES OPERATES BETWEEN THE OTHER TWO AND IS THEREFORE 


RESPONSIBLE FOR MOST OF THE TANKING, 


THE PROCEDURES WHICH FALL INTO THE FIRST GROUP ARE? 


ENTERLINEG ENTERS DATA INTO THE LINE QUEUE. 

ENTEREADYQ ENTERS A LINE INTO THE READY QUEUE IF THE LINE 
| IS NOT ALREADY IN THE READY QUEUE, 

NEXTDCIO PERFORMS WRITES AND SOME INTERROGATES+ 

INTERROGATOR HANDLES INQUIRY REQUEST INTERRUPTS, 


DCIOFINISH960 HANDLES ALL I/0 FINISHED INTERRUPTS FOR 980 


ADAPTERS. 
HELLO HANDLES OITAL@UPS, 
WRURE SPONSE RESPONDS TO WRU AND IS USED AT DIAL*UP TIME. 
QUITTER USED DURING THE PROCESSING OF DISCONNECTSs WRUS 


AND BREAKS, 


GIVEAWAY LINKS MESSAGES INTO THE WORKER QUEUE, 


THERE ARE TWO WAYS IN WHICH THIS SET GF ROUTINES CAN GET CONTROL. 
FIRST» DATA MAY BE PASSED TO ENTERLINEG FOR OUTPUT, THIS CAUSES 


ENTEREADYQ TO BE CALLED» AND POSSIBLY NEXTOCIO, SECOND» THEY GET 
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CONTROL AS A RESULT OF INTERRUPTS GENERATED BY THE TERMINAL UNITS. 


THERE ARE TWO KINDS OF INTERRUPTS GENERATED BY THE TERMINAL UNITS. 

THE FIRST IS AN INQUIRY REQUEST INTERRUPT» WHICH INFORMS THE MCP THAT 
THE STATUS OF A BUFFER HAS CHANGED. THE MCP MUST THEN INITIATE A 
PASSIVE INTERROGATE TO FIND THE ADDRESS OF THE BUFFER IN QUESTION AND 
ITS NEW STATUS. THE SECOND IS AN I/N FINISHED INTERRUPT» WHICH INFTRMS 
THE MCP THAT A READs WRITE OR INTERROGATE IS COMPLETE AND PASSES BACK 
INFORMATION ABOUT THE COMPLETED OPERATION IN THE I/O RESULT DESCRIPTOR, 
THE 1/0 FINISHED INTERRUPT FOR A READ OR A WRITE OPERATION SIGNALS 

ONLY THAT THE DATA HAS BEEN TRANSFERRED BETWEEN CORE AND THE TERMINAL 
UNIT BUFFERS. THE TRANSMISSION OF DATA TO AND FROM THE REMOTE UNIT 

IS HANDLED INDEPENDENTLY BY THE ADAPTERS» AND THE MCP IS INFORMED OF 
ITS COMPLETION VIA AN INQUIRY REQUEST INTERRUPT AND A PASSIVE INTERROGAT 


RETURNING AN IDLE INTERRUPT. 


THIS SYSTEM CF INTERRUPTS AND INTERROGATES ALLOWS THE MCP TO KEEP 
MANY BUFFERS BUSY SIMULTANEQUSLY« FOR INSTANCEs AFTER IT RECEIVES THE 
1/0 FINISHED INTERRUPT FOR A WRITEs IT CAN DO I/0*S ON OTHER LINES 
WHILE THE DATA 3S BEING TRANSMITTED TO THE USER.» THEN» WHEN IT FINDS 
OUT THAT THE TRANSMISSION IS COMPLETEs IT CAN INITIATE FURTHER I/0 


ON THAT LINE. 


THE PROCEDURE WHICH HANDLES THE INQUIRY REQUEST IS INTERRAGATOR. IF 


THERE IS NO 1/0 CHANNEL ASSIGNED TO DATA COMMUNICATIONS» IT ENTERS 
AN INTERROGATE IN THE I/70 QUEUF BY CALLING ITOREQUEST. OTHERWISE» IT 


INFORMS NEXTDCIO THAT AN INTERROGATE NEEDS TO BE DONE, 


ey): 


WHEN NEXTDCIO GETS CONTROL» TF A CHANNEL IS AVAILABLE AND AN INTERROGATE 
NEEDS TO BE DONE» THE INTERROGATE IS INITIATED. OTHERWISEs THE FIRST 
BUFFER LOAD IN THE LINE QUEVE OF THE FIRST LINE IN THE READY QUEUE 

IS WRITTENs USING THE AVAILABLE CHANNEL IF THERE {S ONE OR» IF NO 


CHANNEL IS AVAILABLE» BY CALLING IOREQUEST. 


NEXTCYO GETS CONTROL FROM TWO SOURCES, ONE IS ENTEREADYQs WHICH CALLS 
NEXTDCIO IF NO DATA COMMUNICATIONS 170 IS IN PROGRESS» IN THIS CASE>» 
AN 1/0 CHANNEL MAY OR MAY NOT BE AVAILABLE. THE OTHER SOURCE FROM 
WHICH IT GETS CONTROL IS DCIOFINISH980» IN WHICH CASE AN I/O CHANNEL 
IS AVAILABLE SINCE DCIOFINISH980 GETS CONTROL BEFORE ANYTHING FURTHER 
IS INITIATED ON THE CHANNEL THAT GENERATED THE 1/0 FINISHED INTERRUPT. 
THIS ABILITY OF LINE MAINTENANCE TO KEEP AN I/0 CHANNEL ALLOWS IT TO 
INITIATE YTS OWN 170 UNTIL IT HAS NO MORE TO DO WITHOUT WAITING FOR 
THE 1/0 QUEUEING STRUCTURE OR SHARING THE CHANNEL WITH THE REST OF 

THE SYSTEM. WHEN DCIOFINISH980 GETS CONTROL» IT STARTS AN I/0 AS SOON 


AS POSSIBLE» EITHER BY INITIATING IT ITSELF OR BY CALLING NEXTOCIO. 


SINCE IT PROCESSES ALL OF THE DATA COMMUNICATIONS 1/0 FINISHES» 
DCTOFINISH98O IS THE PRIMARY CONTROLLING ROUTINE FOR THE FIRST GROUP, 
FOR SOME OF THE SPECTAL CASES REQUIRING RELATIVELY EXTENSIVE PROCESSING 
IT CALLS SUCH ROUTINES AS WRURESPONSE AND THE INDEPENDENT RUNNERS» 
HELLO AND QUITTER, MOST CASES» HOWEVER» CAN BE HANDLED ALMOST ENTIRELY 


WITHIN DCIOFINISH980. 


WHEN A PASSIVE INTERROGATE REPORTS A READ READY BUFFERs ODCIOFINISH980 
IMMEDEATELY INITIATES A READ, WHEN IT GETS THE I70 FINISHED INTERRUPT 


FROM THAT» IT CHECKS FOR A GROUP MARK, IF THERE IS ONE» IT GENERATES 


Lieke 


THE CARRIAGE RETURN» THE LINE FEEDs ANDs IF THE SEQ COMMAND IS BEING 
USED» THE SEQUENCE NUMBER» LINKS THEM INTO THE FRONT OF THE LINE QUEUE 
AND CALLS ENTEREADYQ. IT THEN LINKS THE BUFFER TO THE REST OF THE 
MESSAGE AND CALLS GIVEAWAY AND NEXTOCIOe IF THERE IS NO GROUP MARK» 


IT SIMPLY CALLS NEXTOCIO AND LINKS THE BUFFER TO THE MESSAGE, 


WHEN DCIOFINISH980 RECIEVES THE I/0 FINISHED INTERRUPT AFTER A WRITE® 
IT FIRST CHECKS TO SEE IF THE BUFFER WAS ALREADY BUSY, THIS CAN OCCUR 
IF THE USER HAS STARTED TYPING BUT HAS NOT YET FILLED THE BUFFER OR 
TYPED A GROUP MARK OR IF THE TRANSMISSION OF AN EARLIER WRITE TO THE 
USER IS NOT YET COMPLETE. IF THE BUFFER WAS BUSY» THE WRITE COULN NOT 
BE DONE AND SO IT IES RELINKED INTO THE FRONT OF THE LINE QUEUE. IF 
THE BUFFER WAS NOT BUSY» THE CORE BUFFER IS FORGOTTEN AND THE LINE 
QUEUE IS CHECKED. IF THERE IS MORE DATA IN THE LINE QUEUEs ENTEREADYQ 
IS CALLED, IF THERE FS NOTHING IN THE LINE QUEUE> BUT THERE IS DATA 
IN THE TANKs THIS LINE IS ADDED TO THE DETANKING QUEUE.s LATER» WHEN 
THE TRANSMISSION OF DATA TO THE USER IS COMPLETEs DCIOFINISH980 LINKS 
THE LINE INTO THE READY QUEUE IF THERE IS DATA IN THE LINE QUEUE AND 


THEN CALLS NEXTOCIO 


OLDWETRDHAROLD TANKS INPUT AND DETANKS OUTPUT 


NOTIF YCANDE QUEUES UP DATA EVENTS. 
DCWRITE OUTPUTS MESSAGES. 


DCOISKIO WRITES DATA IN CANDE#S TANKS AND GETS NEW CHUNKS 
WHEN NEEDED, 


PAPERTAPEDISKIO WRITES DATA IN PAPER TAPE TANKS AND GETS NEW ROWS 


WHEN NEEDED, 
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CALLITOFF HANDLES THE END OF PAPER TAPE INPUT. 
THE MOST IMPORTANT OF THESE PROCEDURES IS OLDWEIRDHAROLD. 


OLOWEITROHAROLDs ALIAS THE WORKER» DOES MANY STRANGE AND WONDROUS 
THINGS SOME OF WHICH ARE USEFUL. IF HE HAS NOT BEEN FORKED ALREADY» 
HE IS FORKED WHENEVER SOMETHING IS ADDED TO ONE OF HIS QUEUES. WHEN 
GIVEN CONTROL HE FIRST PROCESSES THE WORKER QUEUEs ONE MESSAGE AT A 
TIMEs AND THENs WHEN IT IS EMPTY» DETANKS DATA FOR THE FIRST LINE IN 
_ THE DETANKING QUEUE, AFTER HANDLING A LINE IN THE DETANKING QUEUE, 
HE PROCESSES ANYTHING WHICH WAS ADDED TO THE WORKER QUEUE WHILE HE 
WAS DETANKINGse HE CONTINUES TO PROCESS THE WORKER QUEUE AND THEN 
DETANK DATA FOR A LINE UNTIL HE HAS DETANKED DATA FOR ALL LINES IN 


THE QUEVEs AFTER WHICH HE GOES TO NOTHINGTODO. 


TO PROCESS THE WORKER QUEUEs OLDWEIRDHAROLD SCANS DOWN THE BUFFERS 
LOOKING FOR A LEFT ARROW» PROCESSING BACKSPACES AND CONSOLIDATING AND 
FORGETTING BUFFERS AS HE GOES, WHEN HE HAS A COMPLETE MESSAGE» HE 
CHECKS TO SEE IF THE LINE IS CONNECTED TO CANDEs IS BEING USED FOR 
PAPER TAPE INPUT OR IS CONNECTED TO A USER PROGRAM, 


SINCE CANDE EXPECTS TO FIND INPUT MESSAGES BOTH IN CORE AND ON OTSK» 
THEY ARE WRITTEN INTO 30 WORD ARRAYS, THE NEXT ARRAY TO BE PASSED TO 
CANDE IS FIRSTSEG AND THE ARRAY INTO WHICH DATA IS CURRENTLY BEING 
PLACED IS LASTSEG, THE FIRST WORD OF THE DATA TO BE PASSED NEXT IS 
POINTED TO BY FIRSTOFFSET AND THE NEXT AVAILABLE WORD IN LASTSEG IS 
POINTED TO BY LASTOFFSETs IN A DATA EVENTs CANDE IS PASSED THE ADDRESS 
OF FIRSTSEGs FIRSTOFFSETs AND THE NUMBER OF WORDS OF DATA. THUS» IF 
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FIRSTSEG IS NOT EQUAL TO LASTSEGs CANDE IS PASSED THE ENTIRE SEGNENTs 
AND FIRSTSEG AND FIRSTOFFSET ARE ADJUSTED TO POINT TO THE NEXT SEGMENT. 
IF FIRSTSEG EQUALS LASTSEGs CANDE IS PASSED ALL AVAILABLE INPUT CIE 
EVERYTHING BETWEEN FIRSTOFFSET AND LASTOFFSET) AND FIRSTOFFSET IS 
UPDATED. IF THERE IS NO DATA AVAILABLE» THE FLAG CANDEINPUTREADY IS 


SET. 


WHEN HARRY HAS A MESSAGE FOR CANDEs HE CHECKS TO SEE IF IT WILL FIT 
INTO THE SPACE REMAINING IN LASTSEG. IF IT WONTs HE SETS UP A NEW 
ARRAY BEFORE CONTINUING. HE THEN WRITES THE MESSAGE INTO LASTSEG AND» 
IF CANDEINPUTREADY IS ON» CALLS NOTIFYCANDE,. 


NOTIFYCANDE USES DCOISKIO TO WRITE FIRSTSEG ONTO DISK C(POSSIALY WRITING 
OVER A PREVIOUS VERSION OF THIS SEGMENT WHICH WAS NOT AS FULL) AND 
QUEUES UP A DATA EVENT. IN THIS WAYs CANDE WILL FIND THE DATA BOTH 

IN CORE AND ON OISKe. IT SHOULD BE NOTED THAT SINCE A OISK I/70 MUST 

BE DONE EVERYTIME CANDE REQUESTS DATAs FEWER I/0S ARE PERFORMED WHEN 
CANDE IS AT LEAST A FULL SEGMENT BEHIND LINE MAINTENANCE» HOWEVER » 

AS CANDE FALLS FURTHER BEHIND, MORE CORE IS USED TO HOLD CANDE®S TANKS. 


WIN A FEWs LOSE A FEWe 


MESSAGES FROM PAPER TAPE ARE STORED IN ONE OF TWD 30 WORD AREAS WHICH 
ARE PART OF A 65 WORD AREA GOTTEN FOR THE LINE WHEN THE TAPE COMMAND 
TS RECEIVED. THIS AREA IS SET UP AS FOLLOWS! 


WORD #1 1:20 ADDRESS OF HEADER IN DIRECTORY 
21:27 BASE DISK ADDRESS OF CURRENT ROW 


WORDS 0°31 FIRST 30 WORD BUFFER ARRAYs INCLUDING THE TWO 
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ADDITIONAL WORDS DESCRIBED ABOVE. 
WORDS 32°63 SECOND 30 WORD BUFFER ARRAY 


WORD 64 1/0 FINISH MASK 


THE TWO BUFFER AREAS ARE USED ALTERNATELY IN MUCH THE SAME MANNER AS 
PING*PONG BUFFERS» WHENs HARRY HAS A MESSAGE FROM A PAPER TAPEs HE 
FIRST CHECKS TO SEE IF IT WILL FIT INTO THE CURRENT SEGMENT. IF NOT» 
HE CALLS. PAPERTAPEDISKIO WHICH GETS A NEW ROW IF NECESSARY» WRITES 

THE CURRENT SEGMENT ONTO DISK» SWITCHES THE AREAS AND THEN SLEEPS 
UNTIL ANY PREVIOUS I/O ON THE NEW AREA IS FINISHEDe HARRY THEN CHANGES 
LASTSEG TO POINT TO THE CURRENT AREA AND LASTOFFSET TO THE OFFSET IN 
SEQARRY» WHEN HE IS THROUGH» HE RESETS LASTSEG AND LASTOFFSET AND 


UPDATES OFFSET, 


WHEN HE RECEIVES THE SIGNAL INDICATING THE END OF PAPER TAPE INPUT» 

HE CALLS CALLITOFFs WHICH CALLS PAPERTAPEDISKIO TO WRITE THE REMAINING 
DATA ONTO DISK AND RESETS THE ADINFO AND SEQARRY ENTRIES FOR THE LINE, 
THEN» SINCE THE FLAGS ARE RESET» HARRY SENDS THE END OF PAPER TAPE 
MESSAGE ON TO CANDE, WHICH FURTHER PROCESSES THE DISK FILE BEFORE 
“SENDING A NUMBER SIGN TO THE USERe 


IF THE JOB IS CONNECTED TO A USER» HARRY WRITES THE MESSAGE INTO THE 
USERS TANKs AND CALLS BRINGBACK IF THE JOB WAS SWAPPED OUT TO WAIT 
FOR IMPUT, IF» ON THE OTHER HANDs THERE IS ROOM FOR ONLY 3 MORE 


MESSAGES IN THE TANKs THE USER IS ASKED To “PLEASE WAIT", 


WHEN DETANKING OUTPUT FOR A GIVEN LINE» HARRY FIRST CHECKS TO SEE IF. 


THERE IS ANYTHING IN THE DISK TANKS, IF NOTs HE TAKES EVERYTHING IN 
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THE JOBS CORE TANKS. (NOTE THAT WHEN A JOB IS SWAPPED OUT ITS CORE 
TANK IS WRITTEN INTO ITS DISK TANK,) IF THERE IS DATA ON DISK» HE 
TAKES THE NEXT 56 CHARACTERSe FOR THIS PURPOSE» A POINTER TS KEPT 
WHICH POINTS TO THE NEXT 56 CHARACTER HUNK TO BE QUTPUT. HE THEN CALLS 
OCWRITE» WHICH BREAKS THE MESSAGE INTO BUFFERS OF THE PROPER SIZE FOR 


THE LINE» STORES THEM IN SEGMENTED SAVE AREAS AND CALLS ENTERLINEQ, 


THE PROCEDURES IN THE THIRD GROUP ARES 


COMMS HANDLES CANDES INPUT REQUEST COMMUNICATE. 

COMM13 HANDLES INPUT REQUESTS FROM USER PROGRAMS, 

TWXOUT HANDLES EVERBODYS OUTPUT. 

QUTRAN980 FORMATS OUTPUT FOR 980 ADAPTERS. 

CLEARTANK CALLED DURING A SWAP OUT TO WRITE THE USERS 


QUTPUT ARRAY INTO HIS DISK TANK, 


COMMS SIMPLY FORGETS OLD DATA ARRAYS WHEN CANDE IS THROUGH WITH THEM 
AND THEN CALLS NOTIFYCANDEs INTERLOCKS BETWEEN COMMS AND OLDWEIRNDHAROLDO 
ARE AVOIDED BY JUDICIOUSLY CHOOSING WHERE EACH PROCEDURE LOSES CONTROL 
SQ THAT ONE MAY RUN EVEN WHILE THE OTHER SLEEPS. COMM13 CHECKS TO SEE 
IF THERE IS ANYTHING IN THE USERS INPUT TANKS» IF NOT» IT CALLS SWAP 

TO SWAP THE JOB OUT. OTHERWISE IT GETS THE NEXT MESSAGE FROM DISKs 

AND» IF THE USER HAD BEEN TOLD TO WAIT AND HIS TANK IS NOW HALF EMPTYs 


IT CALLS TWXOUT TO PRINT THE MESSAGE "CONTINUE TYPING®", 


TWXOUT FIRST CHECKS TANKS (€731) WHICH IS SET WHEN BREAK IS TYPED. IF 
IT IS ON» TWXOUT EXITS WHICH IN EFFECT THROWS AWAY THE QUTPUT, THEN 


IT CHECKS THE OUTPUT TANKSe IF ONLY NINE SEGMENTS ARE LEFT AND THE 
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LINE IS CONNECTED TO A JOB ABOVE THE FENCE» SWAP IS CALLED. IF ONLY 


SIX SEGMENTS ARE LEFT» CANDE IS PASSED A SHUT@"UP EVENTe JF THE TANK 
IS FULL» TWXOUT SLEEPS UNTIL THERE IS ROOM FOR THE MESSAGE 


ANY CHARACTERS NOT IN THE 980 CHARACTER SET BY QUESTION MARKS» ADDS 

A CARRIAGE RETURN IF REQUESTED» FOLLOWED BY AS MANY LINE FEEDS AS 
REQUESTEDs AND THEN FOLDS THE LINE IF NECESSARY, IF THERE IS NOTHING 
IN THE LINE QUEUE OR THE TANK FOR THIS LINE» DCWRITE IS CALLED» 
OTHERWISE» THE OUTPUT IS TANKED. IF THE LINE IS CONNECTED TO A CANDE 
TYPE JOB RUNNING ABOVE THE FENCEs THERE IS NO CORE TANK FOR PACKING 
AND SO THE MESSAGE IS WRITTEN INTO THE NEXT DISK SEGMENT. IF THE LINE 
IS CONNECTED TO A JOB ABOVE THE FENCE» THE MESSAGE IS PACKED INTO THE 
CORE TANK UNLESS IT WILL NOT FITs IN WHICH CASE THE TANK IS WRITTEN 
ONTO THE NEXT DISK SEGMENT AND THE MESSAGE IS WRITTEN INTO THE FRONT 
OF THE CORE TANK, | 


DELETE 


QUESTION MARKS» EXCLAMATION POINTS AND EQTS ARE ALL SIGNALED BY THE 
ABNORMAL FLAG IN THE I/0 RESULT DESCRIPTOR FOR A READ, DCIOFINISH98O 
MUST» THEREFOREs SCAN THE BUFFER, IF THERE ARE NO EXCLAMATION POINTS 
(BCL 2)» THE BUFFER SIMPLY CONTAINS QUESTION MARKS» AND IS HANDLED 

IN THE USUAL WAY. IF THERE ARE EXCLAMATION POINTS» AN ACTIVE INTERROGATE 
MUST BE DONE TO FIND OUT IF IT WAS A DELETE OR AN EOT, IF THE BUFFER 

1S "NOT READY" IT IS AN EQT AND IS HANDLED LIKE A DISCONNECT AS 
‘DESCRIBED BELOW. OTHERWISEs IT IS A DELETE ANO SO THE BUFFER OR BUFFERS 
IN THIS MESSAGE ARE FORGOTTEN AND THE "DEL" MESSAGE IS LINKED INTO 
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THE FRONT OF THE LINE QUEUE. 


DIAL UP 


ONE OF THE BITS IN THE ADINFO TABLE SPECIFIES WHETHER OR NOT A LINE 

IS DIALED*UPe. THIS APPLIES TO LINES WHICH ARE DIRECTLY CONNECTED AS 
WELL AS TO THOSE WHICH ARE NOT, IF INPUT IS RECIEVED FROM A DIRECT 
LINE WHICH IS NOT MARKED AS DIALED@UP IT IS TEATED AS A NEW LINE. FOR 
THIS PURPOSE» A CHECK IS MADE DURING THE PROCESSING OF A READ READY 
INTERRUPT TO SEE IF THE LINE IS DIALED*UP, SIMILARLY» A WRITE READY 
ABNORMAL INTERRUPT» WHICH CAN RE EITHER A DIAL*IN OF A WRU» IS ASSUNED 
TO BE A OIAL*IN IF THE LINE IS NOT MARKED AS BEING DIALED*UP. IT IS 
THEREFORE GOOD PRACTICE TO INITIATE A DIRECT LINE WITH A WRU SO THAT 
IT WILL BE TREATED EXACTLY LIKE A DIAL@IN, 


WHEN IT RECTEVES A DIAL®*INs DCIOFINISH980 ADDS A NEW LINE TO THE 
ANSWERING QUEUEs ANDs IF IT HAS NOT BEEN STARTED ALREADY» HELLO IS 
FORKED. AN ENTRY IN THE ANSWERING QUEUE CONSIST OF ONE WORD PER LINE 


WHERE 8 


1038 CONTAINS THE LOGICAL LINE NUMBER 
18:30 CONTAINS THE TIME OF DIAL*UP (PLUS FOUR SECONDS FOR 


LINES NOT DIRECTLY CONNECTED) 


THE QUEVE IS KEPT IN 5 WORD SEGMENTED SAVE AREAS» THE FIRST WORD OF 
AN AREA CONTAINS THE ADDRESS OF THE NEXT AREA» IF THERE IS ONE» IN 
THE 33815 FIELDe THE REMAINING FOUR WORDS ARE ENTRIES TO THE QUEUE. 


AFTER THE FOURTH ENTRY IN AN AREA IS PROCESSED» THE AREA IS FORGOTTEN, 


TEseo 


NEW AREAS ARE OBTAINED WHEN A LINE DIALS*UP AND EITHER THERE ARE NO 


OTHER ENTRIES IN THE QUEUE OR THE FOURTH ENTRY OF THE PREVIOUS AREA 


HAS BEEN USED,. 


HELLO TAKES THE FIRST ENTRY IN THE QUEUE AND CHECKS TO SEE IF THE 
CURRENT TIME IS GREATER THAN THAT STORED IN THE ENTRYe IF THE LINE 

IS DIRECTs THIS IS ALWAYS THE CASE» BUT IF THE LINE REALLY DID DIAL® 
IN» IT MEANS THAT FOUR SECONDS HAVE ELAPSED WHICH PACIFIES ONE OF THE 
GLITCHES IN THE ADAPTER. IF THE CURRENT TIME IS NOT GREATER» HELLO | 
SLEEPS UNTIL IT IS. IT THEN CALLS WRURESPONSE WHICH SENDS OUT THE 
SHARINGLINE AS DIALED*UP IN ADINFO AND IN THE FILE SYSTEM/DISKe AFTER 
ALL ENTRIES IN THE QUEUE ARE PROCESSEDs IT CALLS KILL» LEAVING HARD®@ 


HEARTED CANDE TO HANDLE THE LOG@"IN THROUGH THE USUAL I/0 CHANNELS, 


BREAKs WRU» EQT AND DISCONNECT 


THE OCCURRENCE OF A BREAK» WRUs EQT OR DISCONNECT IS SIGNALED BY AN 
INTERRUPT AND THEREFORE IS RECOGNIZED BY DCIOFINISH980» WHICH QUEUES 
THE APPROPRIATE EVENT FOR CANDEs BLOCKS FURTHER OUTPUT TO THE LINE 

BY SETTING THE PAPERTAPE FLAG» FORKS THE PROCEDURE QUITTERs THROWS 
AWAY ANY INPUT NOT YET ADDED TO THE WORKER QUEUE» DELINKS THE LINE 
FROM THE READY QUEUE AND THROWS AWAY THE LINE QUEUE» AND FINALLY CALLS 
NEXTOCIO. IN ADDITION» IF A WRU IS BEING PROCESSED» WRURESPONSE IS 
CALLED» IF A DISCONNECT» I,Ee DISCONNECT OR EOTs IS BEING PROCESSED» 
THE DIALEDUP AND CANDETHRU FLAGS ARE TURNED OFF» THE DISCONNECT BIT 

IN TANKS JS TURNED ONs AND THE MESSAGE "BYEeeee™ TS ADDED TO THE 


WORKER QUEUE TO MARK THE SPOT AT WHICH THE DISCONNECT OCCURRED. 
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WHEN QUITTER GETS CONTROL AFTER A WRU OR A DISCONNECTs IT TERMINATES 
THE JOB TO WHICH THE LINE IS ATTACHED IF IT CAN BE DS@ED. AFTER A 
BREAK OR IF THE JOB IS NOT DS#ABLEs QUITTER SETS THE 731 BIT IN TANKS 
TO STOP OUTPUT» CLEARS THE INPUT TANK BY RESETTING INPUTANK AND» (TF. 
THE JOB WAS SWAPPED OUT TO WAIT FOR INPUT OR FOR THE OUTPUT TANKS TO 
CLEAR» IT IS BROUGHT BACK AND ALLOWED TO RUN, THENs IN ALL CASES» IF 
CUTPUT IS BEING TANKEDs THE LINE IS DELINKED FROM THE DETANKING QUEUEs 
THE TANKS ARE FORGOTTEN BY RESETTING TANKS» AND» IF IT IS A BREAK OR 
WRU AND CANDE HAD BEEN PASSED A SHUT*UP EVENT» IT IS NOW TOLD TO GO 
AHEAD, CON DISCONNECTs QUITTER SLEEPS UNTIL CANDE SETS THE CANDETHRU 
FLAG BEFORE PROCESSING THE OUTPUT TANKS.) NEXT QUITTER RESETS PAPERTAPE 
ANDs FOR A BREAK OR WRU SENDS CANDE A LINE CLEAR EVENT WHEREAS ON A 


DISCONNECT IT UPDATES SYSTEM/DISKe QUITTER THEN QUITS VIA KILLe 


AFTER RECEIVING A BREAK OR WRU EVENTs CANDE DISCARDS ANY FURTHER 

EVENTS FOR THE LINE UNTIL IT HAS RECEIVED THE LINE CLEAR EVENT ANDs 

IF A JOB WAS RUNNING ABOVE THE FENCEs THE EQJU MESSAGE EVENT. IT THEN 
SENDS THE POUND SIGN RESPONSE TO INDICATE THAT THE USER CAN CONTINUEe 
AFTER A DISCONNECT,» CANDE THROWS AWAY EVENTS UNTIL IT HAS THE "HYEeeee” 
MESSAGE AND» IF APPROPRIATE» THE EQJ MESSAGE. IT THEN MARKS THE LINE 
DISCONNECTED IN JTS OWN ARRAYS AND SETS THE CANDETHRU FLAG FOR THE 


MCP VIA A "16 COMMUNICATE. 
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SYSTEM/DISK, AND HALT/LOAD RECOVERY 


arrnresenense 


THE FILE SYSTEM/DISK CURRENTLY CONTAINS THE FOLLOWING INFORMATION FOR 


EACH LINE ON THE SYSTEMS 


WORD O ADINFO TABLE ENTRY FOR THE LINE 
WORD 1 USER@CODE IF LOGGED@ONs O IF NOT 
WORD 2 TIME OF LAST ACTIVITY 


WORD 3 LENGTH OF TIME BEFORE AUTOMATIC DISCONNECT. 


THE FILE IS INITIALIZED BY THE PROGRAM SYSDISK/MAKER» WHICH READS IN 

THE INFORMATION FOR TNE ADINFO ENTRIES AND ESTABLISHES THE PLOCKING 

FOR THE FILE. 170 TO AND FROM SYSTEM/DISK IS HANDLED BY THE ROUTINE 
SYSDISKIOe WHICH ENSURES THAT THE FILE IS ACCESSED BY ONLY ONE PROCEDURE 
AT A TIME AND ALSO» IF POSSIBLE» USES THE BLOCKING TO MINIMIZE THE 


NUMBER OF I/O"S PERFORMED, 


WORDS 2 AND 3 ARE USED DURING NORMAL SYSTEM OPERATION TO CAUSE AN 
AUTOMATIC DISCONNECT ON LINES WHICH HAVE BEEN IDLE AN EXCESSIVE LENGTH 
OF TIME» CURRENTLY 4 MINUTE DURING LONG=ON AND AFTER A LOG*OFF AND 10 
MINUTES OTHERWISE, THIS TIME IS SET BY CANDE AND STORED IN WORD 3. 
THERE TS ALSO A BIT IN THE MCP WHICH IS SET WHENEVER AN ACTIVITY 
OCCURS FOR THE LINE» FOR INSTANCE» AN 1/0 OR A SWAP. WHEN A TIMER 
INTERRUPT QOCCURSe IF THE BIT IS ON» THE TIME IS STORED IN WORD 2, IF 
THE BIT ©S OFF s AND THE TIME SINCE THE LAST ACTIVITY IS GREATER THAN 


THAT IN WORD 32 AN AUTOMATIC DISCONNECT OF THE USER IS INITIATED, 


AFTER A HALT/LOAD» INITIALIZE CALLS SPREADTHEWORD WHICH USES SYSTEM/ 


DISK TO UPDATE ADINFO AND TO SEND THE *PLOP™ MESSAGE TO ALL LINES 
DIALED*UP. THIS IS ALL THAT CAN BE DONE WITHOUT CANDE, THE REST CF 
HALT/LOAD RECOVERY IS CONCERNED WITH RECOVERING FROM THE LOSS OF CANDE 


AND THEREFORE APPLIES WHENEVER THE CE MESSAGE IS TYPED. 


AFTER A CE MESSAGE, THE PROCEDURE STARTCANDY IS CALLED. IF THERE ARE 
NO TANKS STARTCANDY GETS DISK SPACE FOR A CHUNKs ANDs IN ALL CASES 
QUEUES A TANK CHUNK EVENT. IF THE TANKS EXISTED PRIOR TO THE HALT/ 
LOADs CANDE CAN FIND OUT WHERE THE CHUNKS WERE FROM THIS EVENTs THEN» 
FOR EACH LINE WHICH WAS LOGGED*ON» STARTCANDE QUEUES UP A RESTART 


EVENT. 


A RESTART EVENT IS PROCESSED LIKE A STANDARD DIAL@IN, IF A RESTART 
COMMAND IS ENTERED CANDE ASKS FOR THE OLD LINE NUMSER WHICH IS USED 
TO FIND THE FILES WHICH MAKE UP THE WORK FILE. ITF THE OLD LINE NUMBER 
AND NEW LINE NUMBER ARE DIFFERENTs THE NAMES OF THE FILES ARE CHANGED 
TO REFLECT THE NEW LINE NUMBER, THE FILE 1P <LOGICAL LINE NUMBER> /< 
USER CODE> (SEE "THE WORK FILE") IS SEARCHED TO FIND THE END OF THE 
POINTERSs WHICH IS MARKED BY AN ENTRY OF 10E8+« FOLLOWING THIS ARE AN 
ADDITIONAL 30 WORDS OF INFORMATION CONCERNING THE USER. CANDE USES 
THESE TO RESET ITS INTERNAL PARAMETERS AND TO TELL THE USER THE 
SEQUENCE NUMBER OF THE LAST LINE WHICH WAS SAVED. SINCE THE POINTERS 
AND THE OTHER INFORMATION ARE WRITTEN INTO THE FILE EVERY 10 LINES» 


AT MOST 10 LINES OF INPUT CAN BE LOST ON A HALT/LOAD, 
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MOVING THE FENCE 


WHEN AN MF MESSAGE IS TYPEDs THE PROCEDURE FENCEMOVER IS CALLED. IF 
NECESSARY IT ROUNDS THE VALUE ENTERED FOR THE FENCE UP SO THAT THERE 
WILL BE AN INTEGRAL NUMBER OF CHUNKS ABOVE THE FENCE. THENs IF THE 
RESULTANT VALUE IS IN THE RANGE FROM 8184 TO 28644» THE VALUE IS 
WRITTEN ONTO OISK AT DIRECTORYTOP#19. YF THE VALUE IS OUT OF RANGEs 
AN INV KBD MESSAGE IS OUTPUT, 


AFTER A HALT/LOAD, THE PROCEDURE INITIALIZE COMPARES DIRECTORYTOP+19 
TO THE PREVIOUS VALUE OF THE FENCE. IF THEY ARE DIFFERENT AND 
DIRECTORYTOP+19 IS NOT EQUAL TO ZERO» THE VALUE OF FENCE IS CHANGED, 
BOTH IN CORE AND ON MCP DISKy INITIALIZE IS THEN RESTARTED WITH THE 
NEW FENCE VALUE. | 
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OPERATION OF CANDE 
THE COMMAND AND EDIT LANGUAGE PROCESSOR» CANDE/TSHARERs IS AN INDEPENDEN 
NORMAL STATE PROGRAM WHICH RUNS BELOW THE FENCE. IT IS STARTED DURING 


INITIALIZATION AND CONTINUES FO RUN INDEFINITELY THEREAFTER. 


SINCE CANDE ITS A NORMAL STATE PROGRAM, IT MUST GET INFORMATION ABOLT 
THE STATUS OF JUBS AND LINES FROM THE MCP, THIS ITS DONE IN THE FORM 

OF EVENTS» WHICH ARE QUEUVED BY THE MCP IN THE ORDER OF THETR OCCURRENCE 
AND ARE PASSED TO CANDE WHEN IT REQUESTS ONE VIA A COMMUNICATE. AN 
EVENT IS A FIVE WORD ARRAY. THE FIRST WORD CONTAINS THE LOGICAL LINE 
NUMBER TO WHICH THE EVENT BELONGS AND THE TYPE OF EVENT. THE REMAINING 
WORDS ARE USED TO PASS ADDITIONAL INFORMATION AS REGUIRED BY THE 
OIFFERENT EVENT TYPES. THE POSSIBLE EVENTS ARE LISTED IN TABLE 1. 


IN ADDITIONs THE MCP COLLECTS INPUT FROM THE USERS IN TANKS AND THEN 
ADDS A DATA EVENT TQ THE QUEUE WHEN CANDE ASKS FOR DATA, THUS» CANDE 
CAN CONTROL BOTH THE RATE AT WHICH IT RECEIVES INFORMATION AND THE 
RATE AT WHICH IT RECEIVES NEW DATA. THIS ALLOWS ITY TO PROCESS EACH 
EVENT TO COMPLETION AND ALSO TC PROCESS ONE LINE OF INPUT AS FAR AS 


POSSIBLE BEFORE STARTING ON ANNTHER, 


WHEN CANDE RECIEVES A DATA EVENTs WHICH MAY CONTAIN MANY MESSAGES» 
IT STORES IT AND CONTINUES TO PROCESS THE EVENT QUEUE. WHEN THE EVENT 
QUEUE IS EXHAUSTED» CANDE PROCESSES THE FIRST MESSAGE IN THE DATA 
EVENT BY GENERATING A PSUEDU DATA EVENT CONTAINING ONLY THAT MESSAGE. 


WHEN THE QUEUE IS AGAIN EMPTY, IT PROCESSES THE NEXT MESSAGEs CONTINUING 


ee D 


IN THIS FASHION UNTIL IT HAS PROCESSED ALL THE MESSAGES tN THE DATA 
EVENTs AT WHICH TIME IT ASKS THAT A NEW DATA EVENT BE ADDED TO THE 
QUEUE AND THEN GETS THE NEXT EVENT FROM THE QUEUE, THUSs SINCE CANDE 
CONTROLS THE ADDITION OF DATA EVENTS TO THE EVENT QUEUE AND CAN 
THEREFORE POSTPONE THE PROCESSING OF NEW DATA UNTIL THE EVENT QUEUE 
IS EMPTY» EVENTS RESULTING FROM COMMANDS IN PROCESS AREs IN EFFECT» 
GIVEN PRIORITY OVER NEW COMMANDS, THIS ENSURES A SMOOTH FLOW OF 
INFORMATION THROUGH THE SYSTEM, 


THE MAIN BODY OF CANDE CONSISTS OF A NON@TERMINATING LOOP WHICH 

REQUESTS DATA WHEN IT IS NEEDEDs GETS AN EVENT AND THEN CALLS 
HANDLETHISLINEe HANDLETHISLINE TRANSFERS CONTROL TO THE APPROPRIATE 
ROUTINES THROUGH A CASE STATEMENT IN WHICH EACH STATEMENT IS A PROCEDURE 
STATEMENT, CALLS TO PROCEDURES WHICH HANDLE EVENTS ARE POSITIONED SO 
THAT THE NUMBER OF A PROCEDURE STATEMENT WITHIN THE CASE STATEMENT 

IS EQUAL TO THE NUMBER OF THE EVENT WHICH THE PROCEDURE HANDLES. 
PROCEDURES WHICH ARE NOT DIRECTLY ASSOCIATED WITH AN EVENTs SUCH AS 
THOSE TO HANDLE SPECIFIC COMMANDS» ARE PLACED AFTER THE PROCEDURES 

TO HANDLE EVENTS» NEARLY ALL. TRANSFERS OF CONTROL FROM ONE PROCEDURE 


TO ANOTHER ARE DONE USING THIS CASE STATEMENT. 


THE PROCESSING OF ONE EVENT OFTEN INVOLVES SEVERAL STEPS AND MAY LEAD 

TO FURTHER EVENTS, FOR INSTANCE» A COMMAND IS PASSED TO CANDE AS A 

DATA EVENT AND MUST BE IDENTIFIED BEFORE IT CAN BE PROCESSEDe PROCESSING 
MAY REQUIRE SEVERAL PROCEDURES AND IT MAY INVOLVE WAITING WHILE 
SOMETHINGs SUCH AS A COMPLILEs IS DONE ELSEWHERE. FOR INSTANCEs THE 
PROCEDURE TO HANDLE A RUN COMMAND HAS TO WAIT WHILE THE PROGRAM IS 
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EXECUTED AND THEN MUST REGAIN CONTROL WHEN AN END®*OF*JOB EVENT OCCURS, 
HANDLETHISLINE MUST THEREFORE BE ABLE TO CALL THE APPROPRIATE PROCEDURES 


AND» WHEN THEY OCCUR» TO RECOGNIZE EVENTS FOR WHICH SOMEONE IS WAITING, 


TO DO THIS» FOR EACH LINE CONNECTED TO THE SYSTEM THERE IS AN ARRAY 
WHICH IS USED AS A STACK FOR THAT LINE. THE VARIOUS PROCEQURES USE 
IT FOR SCRATCH AND TO PASS PARAMETERS, IT IS ALSO USED TO STORE 
CONTROL WORDSINFORMATION NEEDED TO START OR RESTART THAT PROCEDURE. 
(SEE TABLE 2). IN ADDITION» WHEN A PROCEDURE GIVES UP CONTROL» IT 


USES THREE VARIABLES TO INDICATE WHAT FURTHER PROCESSINGs IF ANYs IS 


REQUIRED. 
1AM INDICATES WHETHER OR NOT THE PROCEDURE WISHES TO REGAIN 
CONTROL. 
WANT SPECIFIES WHICH OTHER PROCEDURE» IF ANY» SHOULD GET 


CONTROL NEXT 
GIVEN TO THE PROCEDURE SPECIFIED BY WANT OR RETURNED TO THE 


PROCEDURE SPECIFIED IN IAM, 


WHEN WAITFOR TS NON@ZERO» IT IS STORED AND HANDLETHIS LINE IS EXITED 
$O THAT ANOTHER EVENT CAN BE PROCESSED. THENs WHEN THE EVENT SPECIFIED 
BY WAITFOR OCCURSs CONTROL IS TRANSFERRED TO THE MOST RECENT RCW, THE 


POSSIBLE COMBINATIONS OF IAMs WANT AND WAITFOR ARE LISTED IN TABLE 3. 


WHEN AN EVENT WHICH IS NOT THE RESULT OF SOME PREVIOUS EVENT OCCURS» 
SUGH AS A DIAL*UP OR A DATA EVENTs AN RCW FOR THE FINISHED PROCEDURE 
IS STORED IN THE STACK ARRAY AT ITS HIGHEST LOCATION, THEREAFTER» ANY 


FURTHER RCW"S ARE STORED BELOW THE PREVIOUS RCW, THE VARIABLE PREVRCW 
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ALWAYS POINTS TO THE RCW MOST RECENTLY ADDED TO THE STACK, 


THE LOWER PART OF THE STACK IS USED FOR SCRATCH AND FOR PARAMETERSe 
WHEN A NEW PROCEDURE IS GIVEN CONTROL BY HANDLETHISLINEs THE VARIABLE> 
BASE» IS SET TO POINT TO THE FIRST AVAILABLE SCRATCH LOCATION IN THE 
STACK, THE PROCEDURE THEN USES THE VARIABLE SREG TO POINT TO THE 
LOCATION IT IS CURRENTLY USING, BASE IS CHANGED ONLY WHEN CONTROL IS 
TRANSFERRED FROM ONE PROCEDURE TO ANOTHERe THE SPACE IMMEDIATELY ABOVE 
THE BASE IS USED FOR TEMPORARY STORAGE BY THE PROCEDURE AND THE NUMBER 
OF WORDS USED IS STORED IN TEMP, ABOVE ITS TEMPORARY STORAGE» THE 
PROCEDURE STORES ANY PARAMETERS THAT NEED TO BE PASSED TO THE NEXT 
PROCEDURE AND PLACES THE NUMBER OF PARAMETERS IN PARAM, BEFORE ANOTHER 


PROCEDURE IS GIVEN CONTROL» PARAM IS ALSO STORED AT THE NEW BASE, 


IT-58 


TABLE 1, 


EVENTS 


FOR ALL EVENTS» THE RELEVANT PARTS OF WORD O ARE? 


18:7 EVENT NUMBER 


25:38 LOGICAL LINE NUMBER 


THE CONTENTS OF THE REMAINING WORDS IN THE VARIOUS EVENTS ARES 


EVENT 
1 OTAL#uP 
2 BREAK 


3. WHO ARE YOU 
4 LINE CLEAR AFTER 
BREAK OR WRU 


5 DISK CHUNK 


6 OISCONNECT 


7 DATA EVENT 


8 NOT USED 


“WORD CONTENTS 


i-4 


i-4 


1=4 


NOT USED 
NOT USED 
NOT USED 
NOT USED 


DISK ADDRESS OF CHUNK 
DISK ADDRESS OF MESAGE/CANDE 
ADDRESS OF HEADER OF TANK FILE 
DISK ADDRESS OF USERS/CANDE 

NOT USED | 
FIRSTOFFSET» I4Es RELATIVE ADDRESS 
IN SEGMENT OF FIRST WORD OF DATA, 
NUMBER OF WORDS OF DATA 

RELATIVE DISK ADDRESSS OF SEGMENT 


NOT USED 
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9 HALT/LOAD RECOVERY 1 USER CODE 
2-4 NOT USED | 
10 SHUT®UP 1 NUMBER OF EVENT TO WAIT FOR BEFORE 
CONTINUING CUSUALLY ALSO 10 IN 
WHICH CASE THIS WORD IS O FOR THE 
CONTINUE EVENT.) 
2=4 NOT USED 


11 NOT USED 
12 NOT USED 
13 NOT USED 
14 MCP MESSAGE i MESSAGE TYPE (SEE BELOW) 
2-4 NOT USED 
15 PSUEDO DATA EVENT 1 20 IF THIS MESSAGE CONSISTS SOLELY 
FOR ? MESSAGE OF A QUESTION MARK, | 
#0 IF THIS IS A MESSAGE DIRECTED 
TO CANDE (E.G. STATUS)» IN 
WHICH CASE WORDS 1"4 ARE THE 
SAME AS FOR A DATA EVENT 
284 SEE THE DESCRIPTION OF WORD 1 
16 PSEUDO DATA EVENT 1-4 SAME AS FOR A DATA EVENT 


* DISK I/0 COMPLETE 1-4 .NOYT USED 


* THIS EVENT MAY HAVE ANY EVENT NUMBER BUT USUALLY HAS THE NUMBER OF 
THE PROCEDURE WHICH INITIATED THE I/0 IF IT WAS A READ OR A 135 WHICH 
TS DISCARDED» IF IT WAS A WRITEs 


THE MCP MESSAGE TYPES ARE? 
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EOJ = SYNTAX ERROR 
EOJ = OK 

EQJ = DS*ED 

DS MESSAGE 

BO 


LIB.e MAINTe IGNORED 


10 
i1 


FILE REMOVED 
FILE*NAME CHANGED 
SECURED FILE 

ZIP ERROR 


FILE NOT ON DISK 


NOT AN OBJECT CODE FILE 
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BITS 
BITS 
BITS 
BITS 
BITS 


BITS 


BITS 
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TABLE 2 


FORMAT OF AN RCW 


OFF MARKS THIS WORB AS AN OPERAND 


CONTAIN 
CONTAIN 
CONTAIN 
CONTAIN 
CONTAIN 


CONTAIN 


A 2 
THE 
THE 
THE 
THE 


THE 


TO MARK THE WORD AS AN RCW 


VALUE GF SREG 


VALUE GF PARAM 
VALUE OF TEMP 
VALUE GF BASE 


PROCEDURE*S CASE NUMBER» USED TO TELL IT 


WHERE TO RESTART, 


SPECIFY THE PROCEDURE 


NOTES IF THE PROCEDURE HAS NEVER HAD CONTROL» SREGs PARAMs AND TEMP 


ARE EQUAL TO ZERO. 
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IAM WANT 
=0 20 
=0 #0 
=0 60640 
#0 #0 
#0 30 
#0 #0 


WAITFOR 


=0 


=0 


#0 


20 


#0 


#0 


TABLE 3 


ACTION 


GIVE CONTROL TO THE PROCEDURE SPECIFIED IN THE 
FIRST RCW. ; 

CALL THE PROCEDURE SPECIFIED BY WANT 

STORE AN RCW FOR THE PROCEDURE SPECIFIED BY 
WANT» SAVE WAITFOR AND EXIT 

STORE AN RCW FOR IAMs THEN TRANSFER TO WANT 
STORE AN RCW FOR IAMs SAVE WAITFOR AND EXIT 
STORE AN RCW FOR IAMs STORE AN RCW FOR WANT» 


SAVE WAITFOR AND EXIT 
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AN EXAMPLE OF THE COMPLEXITY INVOLVED IN PROCESSING A RELATIVELY 
SIMPLE COMMAND IS THE LIST COMMAND WHEN USED TO LIST THE WORK FILE. 
(SEE FIG. 14) A LIST COMMAND IS RECIEVED AS A DATA EVENT» WHICH IS 
STORED UNTIL ALL OTHER EVENTS HAVE BEEN PROCESSED, THEN» AN RCW IS 
STORED FOR THE FINISHED ROUTINE. THIS WILL ENSURE THAT THINGS ARE 
PROPERLY WRAPPED UP AFTER ALL PROCESSING IS FINISHED. CONTROL IS THEN 
GIVEN TO INPUT WHICH IDENTIFIES THE COMMAND» STORES THE COMMAND AND 
ITS PARAMETERS IN THE STACK» AND THEN CALLS FOR PROCEDURE LISTIT BY 


SETTING WANT233 AND IAM AND WAITFOR EQUAL TO ZERO, 


LISTIT ANALYZES THE PARAMETERS AND THEN ARRANGES FOR CLOSEWORKTABLE 

TO BE CALLED» AND AFTER THAT» FOR DISPATCH TO BE CALLED. IT DOES THIS 
BY SETTING ITAM217,» FOR DISPATCHs AND WANT=25» FOR CLOSEWORKTABLE. AN 
RCW IS STORED FOR DISPATCH AND CONTROL GOES TO CLOSEWORKTABLE»s WHICK 
CLOSES THE WORK TABLE AS DESCRIBED LATER UNDER THE HEADING "WORK FILE.” 
TO OO THIS» IT MAY HAVE TO READ DATA FROM DISKs WHICH IT DOES BY 


CALLING DISKREAD WITH IAM=25 SO THAT IT GETS CONTROL BACK, 


DISKREAD USES 31 WORDS OF TEMPORARY STORAGE INTO WHICH IT READS A 
SEGMENTe IT THEN STORES IT IN ANOTHER ARRAY AND EXITS WITH IAM» WANT 
AND WAITFOR EQUAL TO ZERO. CONTROL IS THEREFORE GIVEN TO THE PROCEOURE 
SPECIFIED IN THE MOST RECENT RCWs WHICH IN THIS CASE IS CLOSEWORKTABLE. 
THE BASE IS RESET TO THE VALUE IN THE RCWs SO THAT THE STACK ALWAYS 
LOOKS THE SAME BEFORE AND AFTER A PROCEDURE TEMPORARILY LOSES CONTROL. 
CLOSEWORKTABLE FINISHES UP AND EXITS WITH IAMs WANT AND WAITFOR EQUAL 
TO ZERO. CONTROL IS GIVEN TO DISPATCH DUE TO THE RCW STORED WHEN 

LISTIT WAS EXITED, DISPATCH CAUSES THE LIST PROGRAM TO BE STARTED 
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ABOVE THE FENCE AND THEN EXITS WITH IAM EQUAL TO 0 AND WANT AND WAITFOR 


EQUAL TO 14s WHICH IS THE NUMBER OF AN MCP MESSAGE EVENT. 


SINCE IT IS NECESSARY TO WAIT, AN RCW IS STORED FOR MCPMSG AND CANDE 
GOES ON TO PROCESS OTHER EVENTS. WHEN IT RECEIVES AN MCP@MESSAGE EVENT 
FOR THIS LINEs HANDLETHISLINE WILL TRANSFER TO MCPMSG ON THE BASIS 

OF THE RCW, THE FIRST MESSAGE WILL BE A BOJ»s SO MCPMSG CONTINUES 19 

WATT BY EXITING WITH IAM AND WAITFOR EQUAL TO 14. AFTER THE EQJ MESSAGE> 
IT EXITS WITH ALL THREE VARIABLES EQUAL TO O, THIS WILL NOW CAUSE 


FINISHED TO BE CALLED WHICH WILL CAUSE AN EXIT. 
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THE WORK FILE 


IF» WHEN PROCESSING A DATA EVENTs CANDE FINDS THAT THE MESSAGE BEGINS 
WITH A SEQUENCE NUMBER OR IS A FIX COMMANDs IT BUILDS A POINTER TO 

THE OFSK TANK ADDRESS OF THE MESSAGE, (THE ADDRESS IS RELATIVE TO THE 
BASE ADDRESS OF A CHUNKs WHICH IS PASSED TO CANDE IN A NEW*DISK*@CHUNK 


EVENTe) THE FORMAT OF THE POINTER IS3 


122. FLAG FOR ENTRY TYPE. THIS FIELD 
=1 IF THE MESSAGE IS OF THE FORM <SEQUENCE=NUMBERD>¢, 
22 If IT IS A NORMAL-ENTRY TO THE WORK FILE, 
=3 IF IT IS A FIX COMMAND, 
4312 DISKLUCs IN WHICH 
444 18 THE CHUNK NUMBER 
8:8 IS THE RELATIVE SEGMENT 
1625  DKOFFSET» SPECIFIES THE WORD IN THE SEGMENT AT WHICH THE 
MESSAGE STARTS, 


21817 SEQUENCE NUMBER IN BINARY, 


THE POINTERS ARE ACCUMULATED IN CORE UNTIL THERE ARE 10 OF THEMs AT 


WHICH TIME THEY ARE WRITTEN INTO THE FILEs 
IP<LOGICAL*LINE*NUMBER>/<USER®@CODE>, 


THIS FILE» WHICH IS BLOCKED €10530)» IS OPENED FOR EACH USER WHEN HE 
LOGS IN. NOTE THAT SINCE NO MORE THAN 10 POINTERS ARE IN CORE AT ONE 


TIME. A USER CAN LOSE AT MOST 10 RECORDS DURING A HALT/LOAD. 


WHEN A COMMAND AFFECTING THE WORK FILE IS ISSUED» THE WORK FILE IS 
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SORTED AND UPDATED, FIX COMMANDS ARE PROCESSED AND» IN THE CASE OF 
RECORDS WITH DUPLICATED SEQUENCE NUMBERS, ONLY THE MOST RECENTLY 
ENTERED IS RETAINED. SEQUENCE NUMBERS AND LEADING BLANKS ARE STRIPPED 
FROM THE FRONT OF THE RECORD. IF NECESSARYs PRECEDING ZEROES ARE ADDED 
JO SEQUENCE NUMBERS TO MAKE THEM EIGHT DIGITS LONG» AND THEN THEY ARE 
STORED IN CHARACTER POSITIONS 73°80, ENOUGH BLANKS ARE ADDED TO THE 
END OF THE MESSAGE TO MAKE IT 72 CHARACTERS LONGe THE RESULTING RECORD 
CONSISTS OF 10 WORDS WHERE 


WORDS O0°8 CUNTAIN THE ALPHANUMERIC MESSAGE 


WORD 9 CONTAINS THE ALPHANUMERIC SEQUENCE NUMBER 

THE SORTEDs UPDATED RECORDS ARE STORED IN FILE 
1S<LOGICAL*@LINE=NUMBER>/<USER*CODE> 

POINTERS TO THE NEW SOURCE FILE ARE STORED IN THE FILE 
LT<LOGICAL®@LINE*NUMBER>/<USER*®CODE> 


IF MORE DATA IS ENTERED AFTER THE WORK FILE HAS BEEN SORTED AND UPDATED» 
POINTERS CAN AGAIN BE STORED IN LP<LOGICAL*LINE =NUMBER>/<USER=CODE>. 
WHEN THE WORK FILE IS AGAIN UPDATEDs THESE POINTERS CAN BE SORTED AND 
THEN MERGED WITH THOSE IN 1T<LOGICAL*LINE=NUMBER>/<USER=CODE>, FROM 

THE RESULT» A NEW SOURCE FILE AND A NEW FILE OF POINTERS CAN BE 
CONSTRUCTED IN 1S<LOGICAL@LINE*NUMBER>/<USER®*CODE> AND 17<LOGICAL®= 


LINE*NUMBER>/<USER*CODE> RESPECTIVELY. 


THUSs THE WORK FILE CONSISTS OF FOUR PARTS3 
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1) MESSAGES IN THE DISK INPUT TANKS, 

1) THE FILE 1P<LOGICAL*LINE*NUMBER>/<USER*CODE> WHICH CONTAINS 
POINTERS TO THE MESSAGES IN THE TANKS, 

3) THE SORTEDs UPDATED SOURCE FILE. 

4) THE FILE 17<LOGICAL*LINE*NUMBER>/<USER*CODE> WHICH CONTAINS 

POINTERS TO THE SOURCE FILE, 


QROINARILYs THE SOURCE FILE IS 1S<LOGICAL*LINE*NUMBER>/<USER@CODE> 
BUT AFTER A LOAD COMMAND THE FILE SPECIFIED IN THE COMMAND IS USED 
AS THE SOURCE AND THE POINTERS POINT TO IT, 


THE WORK FILE IS SORTED AND UPDATED BY PROGRAMS WHICH RUN ABOVE THE 
FENCE, THIS FREES CANDE TO SERVICE OTHER USERS AND ALSO ENSURES THAT ~ 
ANYTIME A USER REQUIRES A SIGNIFICANT AMOUNT OF PROCESSINGs HE SHARES 
TIME AND CORE WITH OTHER USERS THROUGH THE SWAPPING MECHANISM, THE 
VERBS WHICH CAUSE THESE PROGRAMS TO BE RUN ABOVE THE FENCE ARE LOADs 
LIST» COPYs RESEQs APPEND» MERGEs DELETE AND» IF THE WORK FILE IS NOT 


SORTED WHEN THE COMMAND IS ISSUED» SAVE. 


TO FREE CANDE EVEN FURTHER FROM THE MENIAL CHORES OF FILE HANDLING» 

ALL OF ITS FILE OPERATIONS ARE DONE BY THE MCP. USING COMMUNICATES, 
CANDE TELLS THE MCP TO OPEN AND CLOSE FILES» TO PERFORM READS AND 

WRITES AND TO CHECK THE EXISTENCE AND SECURITY STATUS OF FILES. IT 
PASSES SUCH NECESSARY INFORMATION AS FILE NAMES» DISK AND CORE ADDRESSES 
AND THE NUMBER OF THE PROCEDURE REQUIRING THE FILE OPERATIONe WHEN 

THE OPERATION IS FINISHED» THE MCP QUEUES AN EVENT WHICH IT IDENTIFIES 
BY THE PROCEDURE NUMBER WHICH WAS PASSED TO IT IN THE COMMUNICATE, 


THIS EVENT TELLS CANDE THAT THAT PROCEDURE CAN CONTINUE ITS PROCESSING, 
IN THIS WAYs CANDE CAN PROCESS OTHER EVENTS WHILE I/0 OPERATIONS ARE 
BEING PERFORMED FOR IT-e 
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THE NEGATIVE COMMUNICATES 


SAE EI TE EE EE eg a A 


THE FOLLOWING IS A LIST OF THE NEGATIVE COMMUNICATES» WHICH HAVE BEEN 


ADDED TU THE MCP FOR TIME SHARINGe OF THESE» ONLY #11 AND ©13 ARE NOT 


USED BY CANDE. 


MCP PROCEDURES» 


COMMUNICATE 


| 
me 
*3 
“4 
“5 
=6 
“7 
“8 


“9 


mae d 


FOR THOSE COMMUNICATES WHICH SIMPLY PROVIDE ACCESS TO 


THE PROCEDURE IDENTIFIER IS LISTED. 


USE 


CANDE*S DISK 1/0 
REQUEST FOR NEXT EVENT 
GETESPDISK 
FORGETESPDISK 

DATA EVENT REQUEST 
GETUSERDISK 
FORGETUSERDISK 
DISKWAIT 

CONTROL CARDS 

USER CODES 

TWXOUT FOR USER PROGRAMS 


TWXOUT FOR CANDE 


_ USER PROGRAMS INPUT REQUEST 


AUTOMATIC SEQUENCING 

FILE CREATIONs SECURITY MAINTENANCE» LOG*ONS»s LQG= 
OFFS» LIBRARY MAINTENANCE AND PAPER TAPE 
DISCONNECTS 

CHARGE CODES 
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WHEN A PROCEDURE IN CANDE NEEDS TO PERFORM A COMMUNICATEs IT CALLS 
ANOTHER PROCEDURE CONSISTING ONLY OF THE COMMUNICATE STATEMENT AND 
PASSES IT A LIST OF PARAMETERS, THUS» WHEN SHORTCOMMUNICATES GETS 
CONTROL TO PROCESS THE COMMUNICATEs THE FOLLOWING ITEMS ARE IN THE 
STACK? 


MARK STACK CONTROL WORD 


FROM THE CALL ON THE COMMUNICATE 
PARAMETERS | 


PROCEDURE 
RETURN CONTROL WORD . 


INTERRUPT RETURN CONTROL WORD FROM THE INTERRUPT GENERATED BY 
INTERRUPT CONTROL WORD THE COM OPERATOR 


MARK STACK GONTROL WORD 


FROM THE CALL ON SHORTCOMMUNICATES 
RETURN CONTROL WORD 


SHORTCOMMUNICATES USES FeRELATIVE ADDRESSING TO ACCESS THE PARAMETERS, 
IT PROCESSES THE 109 “14 AND ©16 COMMUNICATES ITSELF AND CALLS OTHER 
PROCEDURES FOR THE OTHER COMMUNICATES, 


THE ACTIONS PERFORMED BY THE "102 "14 "16 AND "17 COMMUNICATES ARE 
RELATIVELY SIMPLE, A =10 COMMUNICATE JUST STORES THE USER CODE IN 
USERCOQDE. A =14 IS USED TO PASS THE INFORMATION FOR AUTOMATIC SEQUENCING 
TO SEQARRAY, A "16 RESULTS IN CANDETHRU BEING SET TO ONEs THE VALUE 

OF WHICH JS EXPLAINED IN THE DESCRIPTION OF DISCONNECTS, A "17 SIMPLY 
SPOUTS A CHANGE OF CHARGE CODE MESSAGE» WHICH IS ENTERED IN THE LOGe 

THE ©5 AND #13 COMMUNICATES ARE HANDLED By COMMS AND COMM! 3 RESPECTIVELY | 
WHICH ARE EXPLAINED IN THE DISCUSSION OF LINE MAINTENANCE, 


A #1 COMMUNICATE IS HANDLED BY COMM1» WHICH DOES DISK READS AND WRITES 


FOR CANDE,. IN ADDITION TO THE CORE AND DISK ADDRESSES» THE SIZE AND 
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A READ/WRITE FLAGs CANDE ALSO PASSES COMM1 THE LOGICAL LINE NUMBER 
AND A "REASON", I,£. THE NUMBER OF THE CANDE PROCEDURE DOING THE I/0- 


THIS ALLOWS THE MCP TO PASS CANDE AN I/O COMPLETE EVENT WITH THAT 
NUMBER SO THAT THE PROCEDURE MAY PROCEED, 


COMM! GETS AN AREA FOR THE EVENTs PUTS THE REASON AND LINE NUMBER IN 
WORD O» ARRANGES TO HAVE THE I/O RESULT DESCRIPTOR IN WORD 1s CALLS 
DISKIO» SNEAKILY FLAGGING IT AS A CANDE I/O» AND RETURNS. WHEN THE I/ 
0 1S COMPLETEs THE EQUALLY DEVIOUS IOFINISH PROCEDURE RECOGNIZES THIS 


AS A CANDE £/0 AND QUEUES UP THE EVENT. 


A #2 COMMUNICATE» WHICH IS CANDES WAY OF ASKING FOR ANOTHER EVENT» 
TS HANDLED BY COMM2, EVENTS ARE KEPT IN SEGMENTED SAVE AREAS AND ARE 


LINKED BY THE FIRST WORD OF THE AREAs WHICH HAS THE FORMAT. 


1:1 OCCUPIED BIT 
212 = SIZE CODE 

1887 EVENT NUMBER» I.€+ THE REASON 
25:8 LOGICAL LINE NUMBER 


33315 ADDRESS OF NEXT EVENT IN THE QUEUE 
THE HEAD AND TAIL OF THE EVENT QUEUE ARE KEPT IN EVENT. 


COMM2 FORGETS THE AREA FOR THE PREVIOUS EVENT AND THEN CHECKS THE 
EVENT QUEUE. IF THERE ARE NO EVENTS» IT EITHER RETURNS OR SLEEPSs» 
NEPENDING ON WHETHER OR NOT CANDE INDICATED THAT IT NEEDED TO WAIT 
FOR AN EVENTe IF THERE IS AN EVENTs OR AFTER WAITINGs THE NEXT EVENT 


AND THE CURRENT TIME ARE GIVEN TO CANDE. 
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CANDE USES A #©9 COMMUNICATE TO PASS THE MCP CONTROL CARDS» WHICH IT 

USES FOR SUCH THINGS AS INITIATING JOBS ABOVE THE FENCE AND LIBRARY 
MAINTENANCE, COMM9 SIMPLY FORKS CONTROLCARD AND GIVES IT THE INFORMATION 
CANDE ALSO PASSES THE REASON WHICH IT WANTS USED ON THE MCP MESSAGE 
EVENTS WHICH RESULT FROM THE PROCESSING OF THE CONTROL CARDe. SINCE 

THE REASON IS ALWAYS THE SAME» THERE IS NO NEED TO GO INTO THE DETAILS 
OF HOW THIS IS DONE, BESIDESs IT WOULD SPOIL THE READERS FUN, 


A #15 COMMUNICATE IS USED BY CANDE FOR NINE DIFFERENT THINGS? 


0) TO PERFORM A DIRECTURY SEARCH FOR A FILE AND A SECURITY 
CHECK ON THE USER WHO WISHES TO ACCESS IT. 

1) TO CREATE A FILE, 

2) TO RECORD LOG*ONS AND LOG*OFFS. 

3) TO REMOVE A FILE. 

4) TO REPLACE A CURRENT FILE BY A NEW FILE. 

5) TO CHANGE THE NAME OF A FILE. 

6) TO START A JOB, 

7) TO CHANGE THE SECURITY STATUS GF. A JOBe 

8) TO START A PAPER TAPE. 


THE INFORMATION PASSED TO COMM15 INCLUDES A FLAG SPECIFYING WHICH 
TYPE OF COMMUNICATE THIS IS» THE USER CODEs FILE*NAMES*» THE LOGICAL 
LINE NUMBER» AND A REASON TO BE USED IN THE RETURN EVENTe THIS 
INFORMATION IS STORED IN A SEGMENTED SAVE AREA WHICH IS ADDED TO THE 
INDIAN QUEUE, THE FIRST WORD OF THIS AREA CONTAINS A LINK TO THE NEXT 
ENTRY IN THE QUEUE IN 33815» AND THE REASON ANO LINE NUMBER IN 1832156 
THUS» THE SAME AREA CAN BE USED FOR THE ANSWERING EVENT. THE HEAD AND 
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TAIL OF THE INDIAN QUEUE ARE KEPT IN INDIAN, 


THE QUEUE IS PROCESSED BY INDIANBOYs WHICHs IF IT IS NOT ALREADY 

RUNNING OR IN THE FORK QUEUE, IS ADDED TO THE FORK QUEUE WHENEVER 
SOMETHING IS ADDED TO THE INDIAN QUEUE, FOR AN ENTRY OF THE FIRST 
TYPEs IE TYPE O» HE JUST CALLS DIRECTORYSEARCH AND» IF THE FILE IS 


THEREs SECURITYCHECK. THE RETURN EVENT HAS THE FOLLOWING INFORMATIONS 


WORD 1 PROTECT CODE» SAME AS ALGOL SEARCH STATEMENT, 
WORD 2 181 INTERLOCK 

18315 HEADER ADDRESS 

3686 FILE TYPE 

4236 OPEN COUNT. 
WORD 3 ENF COUNT. 


WORD & DISK ADDRESS OF FIRST RECORD. 


IF THE SPECIFIED FILE DOES NOT EXISTs WORD 1 CONTAINS A #4 AND THE 


REMAINING WORDS ARE UNDEFINED, 


FOR THE SECOND TYPEs INDIANBOY SETS UP THE FILE HEADER AND DOES A 


DIRECTORYSEARCH TO SEE IF THERE IS ALREADY A FILE BY THAT NAMEs IN 
WHICH CASE HE REMOVES ITe HE THEN CALLS ENTERUSERFILE TO ENTER THE 
FILE IN THE DIRECTORY AND PASSES BACK TO CANDE AN EVENT CONTAINING 


THE DISK ADDRESS OF THE FILE IN WORD 1 AND THE ADORESS OF THE HEADER 


IN WORD 2, 


FOR THE THIRD TYPEs INDIANBOY SIMPLY MAKES THE NECESSARY CHANGES IN 


SYSTEM/DISK AND SPOUTS THE APPROPRIATE MESSAGE, 
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CANDE USES TYPES 3» 4 AND 5 FOR LIBRARY MAINTENANCEe TO REMOVE A FILE 
CTYPE 3) INDIANBOY CALLS OIRECTORYSEARCH, TO REPLACE AFILE (TYPE 4) 
HE USES DIRECTORYSEARCH TO REMOVE THE OLD FILE CIF PRESENT) AND THEN 
TO CHANGE THE NAME OF THE NEW FILE TO THAT OF THE OLD FILE. THIS IS 
USED FOR SUCH THINGS AS SAVE COMMANDS» WHICH REQUIRE THAT THE CURRENT 
DISK FILE BE REPLACED BY THE CURRENT WORK FILE. A CHANGE OF NAME (¢ 
TYPE 5) IS AGAIN DONE USING DIRECTORYSEARCH,. AFTER COMPLETING ONE OF 
THESE OPERATIONS» INDIANBOY QUEUES AN EVENT USING THE MCP MESSAGE 
CODES 5s 6 AND 7 CSEE TABLE 1) TO INDICATE THE RESULTS. 


TO START A JOB FOR CANDE CTYPE 6)» INDIANBOY CHECKS TO SEE IF THE 

FILE IS THEREs IF IT IS OBJECT CODEs AND IF THE USER CAN ACCESS IT 
UNDER THE FILE SECURITY SYSTEM. IF THE JOB FAILS ANY OF THESE TESTS» 
AN APPROPRIATE MCP MESSAGE EVENT IS QUEVEDs OTHERWISE THE JOB IS ADDED 
TO THE SCHEDULE AND SELECTRUN IS FORKED, | 


FOR TYPE 7» INDIANBOY IS PASSED THE WORDS TO BE USED IN WORDS 2) 5 
AND 6 OF THE FILE HEADERs IF THE FILE IS PRESENT» HE SIMPLY MAKES THE 
INDICATED CHANGES IN THE HEADER» IF THE REQUESTOR IS CANDE HE QUEUES 
UP EITHER AN IGNORED EVENT CMP MESSAGE #5) OR A CHANGED EVENT (#6) 


WHEN HE IS FINISHED, 


FOR TYPE 8» INDIANBOY INITIALIZES SEQARRAY AND THEN CREATES THE FILE 
FOR TANKING AS HE WOULD FOR A TYPE 1 REQUEST, HE ALSO GETS 65 WORDS 


FOR THE CORE TANKS» INITIALIZES THEM AND SENDS THE OK MESSAGE AND AN 
X"0N, 


INDIANBOY CONTINUES TO PROCESS THE INDIAN QUEVE UNTIL IT IS EXHAUSTED» 


AND THEN CALLS KILL, 
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APPENDIX A 


DESCREPANCIES BETWEEN THE INITIAL RELEASE AND THIS MANUAL 


THE FOLLOWING ITEMS WHICH ARE DESCRIBED IN THIS MANUAL ARE EITHER NOT 


IN THE INITIAL RELEASE OR ARE IMPLEMENTED DIFFERENTLY THAN DESCRIBED. 


1. 


26 


4. 


ALTERNATE SPO. IN THE INITIAL SYSTEMs THE ALTERNATE SPO CAN 
BE USED ONLY FOR OUTPUTe THE REAL SPO MUST THEREFORE BE USED FOR 
ALL KEYBOARD INPUT MESSAGES» EVEN IF IT HAS BEEN US*EDe AN ATTEMPT 
TO TYPE IN ANYTHING FROM AN ALTERNATE SPO WILL CAUSEs AT BEST» | 


CONFUSION ANDs AT WORST» A HUNG SYSTEM. 


USER/CANDE,. INITIALLY ONLY THE PASSWORD AND TIME OPTION 
CAROS WILL BE IMPLEMENTEDe THE OTHER OPTION CARDS WILLL BE IGNORED 


IF INPUT, 


FORTRANe LABELS FOR REMOTE FREE FIELD FORMAT MUST BE IN 
COLUMNS 1 THROUGH 5 FOLLOWING THE SEQUENCE NUMBER. SINCE THE 
LABEL MUST BE SEPARATED FROM A SEQUENCE NUMBER LESS THAN 6 
CHARACTERS LONGs LABELS CAN BE AT MOST 4 CHARACTERS LONG WHEN 
SEQUENCE NUMBERS SHORTER THAN 8 CHARACTERS ARE USED. 


MESSAGES, THE IN AND OT MESSAGES CANNOT BE USED AT ALLe 


